CP Command Reference for General Users (Rel 6 PLC 17 Apr81) Page 41 (53 of 213)

Section 5. Format of CP Commands
The rormats are described in order except for
special such as the asterisk (*) and the pound sign (I), which appear first.
The command formats are presented in the following order: • Command Name: Identifies the name of the command. The name is also included at the top of the page for easy reference. • Privilege Class: States the privilege class of the command as Any or
G. • of Function: Describes the use. • Syntax: Lists the syntax of the command with all the possible operands that you can use. • Operand Description: Describes the function of each operand and any values that you can include in the operand. • Usaqe Notes: Contains notes about special uses of the command, its operands, combinations of commands or operands. • Responses: Describes the CP responses sent to the terminal, caused by of the command. These responses are command responses
and are not to be construed as VM/370 system messages. The command
responses are not prefixed and, therefore, they are not contained in Only CPcommand responses applicable to the
class 3 and class user are contained in this publication. The execution of certain commands may produce system messages.
For example, if you issue the following command:
spool copy 23 you receive the following system message: DMKCSP022E VADDP MISSING OR INVALID DMK is the CP component identifier. CSP is the module identifier (SPOOL command) • 022 is the return code.
E is the action code (indicating a severity classification).
msqtext jescribes the error situation in the command line. In this
case, Printer (OOE), Punch (000), or Reader (OOC) was omitted.
Refer to for additional information on system messaqe formats and user action. Section 5. Format of CP :ommands q1

* Use the asterisk (*) to annotate the terminal console sheet or terminal
display screen data with a comment. This commentary also appears in the
virtual c)nsole spool file (if the console spoolinq function is invoked
for the virtual machine). The format of the * (comment) command is:
r---------- , *
L anycomment
42 IBM VM/370 CP Command Reference for General Users --, I _________J

Previous Page Next Page

Extracted Text (may have errors)

40 IBM VM/370 CP Command Reference for General Users

Section 5. Format of CP Commands
The rormats are described in order except for
special such as the asterisk (*) and the pound sign (I), which appear first.
The command formats are presented in the following order: • Command Name: Identifies the name of the command. The name is also included at the top of the page for easy reference. • Privilege Class: States the privilege class of the command as Any or
G. • of Function: Describes the use. • Syntax: Lists the syntax of the command with all the possible operands that you can use. • Operand Description: Describes the function of each operand and any values that you can include in the operand. • Usaqe Notes: Contains notes about special uses of the command, its operands, combinations of commands or operands. • Responses: Describes the CP responses sent to the terminal, caused by of the command. These responses are command responses
and are not to be construed as VM/370 system messages. The command
responses are not prefixed and, therefore, they are not contained in Only CPcommand responses applicable to the
class 3 and class user are contained in this publication. The execution of certain commands may produce system messages.
For example, if you issue the following command:
spool copy 23 you receive the following system message: DMKCSP022E VADDP MISSING OR INVALID DMK is the CP component identifier. CSP is the module identifier (SPOOL command) • 022 is the return code.
E is the action code (indicating a severity classification).
msqtext jescribes the error situation in the command line. In this
case, Printer (OOE), Punch (000), or Reader (OOC) was omitted.
Refer to for additional information on system messaqe formats and user action. Section 5. Format of CP :ommands q1

Help

• The use of brackets denotes choices, one of which be selected. • The representation
r ,
i A I B I C
L J
indicates that you may enter A, B, or C, or you may omit the field.
In instances where there are nested
lines, the followinq rule applies;
dependent apon the selection of the braces or brackets on the text
nested operand selection is
operand of a higher level of
Nestinq levels are represented as follows
[Level 1 rLevel 2 [Level 3 ]]]
[filename rfiletype [filemode]]] Where the hiqhest level of nesting is the operand that is enclosed in only one pair of brackets and the lowest level of nestinq is the operanj that is enclosed by the maximum number of brackets. Thus in
the previons example, the user has the option of selecting a file by
filename only, or filename filetype only or by filename filetype The user cannot select filetype alone because filetype is
nested within filename; and, as noted, our rule states: the higher
level nestinq must be selected in order to select the next level level) operand. The same is true if the user wants to select filemoje; filename and filetype must also be selected. • An ellipsis indicates that the preceding item or group of items may
be repeated more than once in succession. The representation (spoolij1 spoolid2 ••• }
inaicates that more than one spoolid may be coded within the braces.
section 4. Notational Conventions 39

40 IBM VM/370 CP Command Reference for General Users

Previous Page Next Page

#CP Use the i:P command execute a CP command while in a virtual macn1ne
command enviLonment without first signaling attention to get to the CP
command enviLonment. The format of the #CP command is:
r #CP rcommandline1 rlcommandline2 # ••• ]1
L , ______ J
commandline specifies the name and operands for you want to issue. You must =ommandline with at least one blank.
the CP command or
precede the first
1. The sign (Il shown in the preceding format is the VM/370 slpplied line end symbol. However, your installation can Ledefine the logical line end symbol currently in effect for your viLtlal machine. If you have redefined the logical line end tc
o is an invalid command; you must substitute your line
end symbol for the pound sign when using this command.
2. FOL the command to operate, the following conditions must be met: • The virtual machine must be operating with SET LINEDIT ON (a
default). • The first three characters of the edited line (crppercase or lowercase) with the "t" representing
line end symbol currently defined.
must be #CP the logical • At least one blank must separate the #CP from any command line. not use attention interruption in any part of the line or to
enter the line. • If in a virtual machine command environment, the virtual machine mcrst have isscred a FEAD for at least four bytes of data. If the
READ is for less than three bytes, you must use the attention key to enter the CP environment. 3. You can enter multiple command lines as operands of the #CP command
provided that (a) the virtual machine's console READ is for at
least the number of bytes required to enter the entire line and (b)
all commandlines to ,be executed must be separated by the current
logical line end symbol. u. If enter #cp with no operands, the virtual machine enters the
CP CP cancels the virtual machine's console READ by retuLninq a unit exception status for the virtual console. The
virtlal operatinq system then reissues the console READ to allow you to key in the appropriate response to a previous message from
that machine's operating system. 5. If have previously issued a TERMINAL APL ON command, you cannot
issue the #CP command. This is because CP does not translate the #CP When APL is set on, CP uses a different set of
Section 5. Format of CP Commands 43

#CP tables and does not recoqnize the logical line end
character (#).
r--------- I I Command I #CP I , #CP guery files #CP query files#query users
data enteredt#CP msg op is tape
available #CP data entered
data entered¢#CP tcp query files¢data entered
L __ _ System Action Your virtual machine enters CP environment. QUERY command executed.
Two separate QUERY commands
executed.
"Data entered" is ignored. You send a message to the
operator. You enter CP environment and CP interprets "data entered"
as an invalid operand.
"Data entered" is ignored. You enter CP environment. QUERY command is not executed;
console input (data entered)
passes to the virtual machine. figure 6. System Action Taken on a #cP Command
If yOU enter fCO without a commandline, you receive this message:
CP
If you enter #CP with commandlines, you receive the responses
appropriate to the individual commands you entered.
44 IBM CP Command Reference for General Users

Previous Page Next Page

Page 3Section 1. The VM/370 Command Languages click to expand contents

Page 7Section 2. The CP Command Language click to expand contents

Page 13Section 3. CP Command Usage click to expand contents

Page 35Part 2. Reference Information click to expand contents

Page 41Section 5. Format of CP Commands click to expand contents

Page 173Appendix. VM/370 Command Summary click to expand contents

Extracted Text (may have errors)

Help

loading