1 01/14/87  print_configuration_deck, pcd
 2 
 3 Syntax as a command:  pcd {card_names} {-control_args}
 4 
 5 
 6 Syntax as an active function:  [pcd {card_names} {-control_args}]
 7 
 8 
 9 Function:  displays the contents of the Multics configuration deck.
10 The data is kept up-to-date by the reconfiguration commands and, hence,
11 reflects the current configuration being used.  The active function
12 returns the selected cards in quotes, separated by a single space.
13 
14 
15 Arguments:
16 card_names
17    are the names of the particular configuration cards to be displayed.
18    You can give up to 32 card names (see the _^HM_^Hu_^Hl_^Ht_^Hi_^Hc_^Hs _^HS_^Hy_^Hs_^Ht_^He_^Hm _^HM_^Ha_^Hi_^Hn_^Ht_^He_^Hn_^Ha_^Hn_^Hc_^He
19    _^HP_^Hr_^Ho_^Hc_^He_^Hd_^Hu_^Hr_^He_^Hs _^HM_^Ha_^Hn_^Hu_^Ha_^Hl, AM81, for the names of the configuration cards).
20 
21 
22 Control arguments:
23 -exclude FIELD_SPECIFIERS, -ex FIELD_SPECIFIERS
24    excludes particular cards or card types from being displayed.  You
25    can supply one to 14 field specifiers with each -exclude and up to
26    16 -exclude control arguments.  To be eligible for exclusion a card
27    must contain fields that match all field specifiers selected with
28    any -exclude.
29 -label, -lbl
30    displays cards with mnemonic labels for each field.
31 -match FIELD_SPECIFIERS
32    selects particular cards or card types to be displayed.  You can
33    give one to 14 field specifiers with each -match and up to 16 -match
34    control arguments.  To be eligible for selection a card must contain
35    fields that match all field specifiers supplied with any -match.
36 -no_label, -nlbl
37    does not display field labels.  (Default)
38 -pathname PATH, -pn PATH
39    displays the configuration deck in the segment specified by PATH,
40    rather than the configuration deck of the live system.
41 
42 
43 Notes:  Field specifiers can consist of a complete card field or a
44 partial field and an asterisk.  An asterisk matches any part of any
45 field; for example, the field specifier "dsk*" matches any card
46 containing a field beginning with the characters "dsk".  You can give
47 specifiers for numeric fields in octal or decimal, but if decimal they
48 must contain a decimal point.  You can't use asterisks in numeric field
49 specifiers.  All numeric field specifiers are converted to decimal and
50 matched against numeric card fields, which are also converted to
51 decimal.  Hence, the field specifier "1024."  matches a card containing
52 the octal field 2000, and the field specifier "1000" matches a card
53 containing the decimal field 512.
54 
55 Selection is performed as follows.  If you give no card names, all
56 cards are selected; if you supply any card names, only the cards
57 matching those names are selected; and if more than one card exists
58 with a specified name, all such cards are displayed.  If you request a
59 nonexistent card, an error message is displayed.  If you give any
60 -match arguments, those eligible cards are matched against all field
61 specifiers of each -match argument group; however, at least one -match
62 group must have all its field specifiers match some field on the card
63 to make that card eligible.  A similar algorithm is used for any
64 -exclude argument groups.  So, if a card is eligible and you supply
65 -exclude arguments, then at least one -exclude group must have all its
66 field specifiers match some field on the card to make that card
67 ineligible.  If no match for a given card name or -match group is found
68 in the configuration deck, nothing is displayed for that name or group
69 and no error is displayed.  If you give no arguments, the complete
70 configuration deck is displayed.
71 
72 Specify all card names before the first -match or -exclude argument.
73 Field specifiers following a -match or -exclude argument include all
74 arguments until the next -match or -exclude argument.
75 
76 No action is taken for misspelled arguments or valid arguments for
77 which there are no corresponding configuration cards.