Retro1.org codex

CP

There are three versions of the CP command.  "CP" can be issued from the CP
environment as well as from the CMS environment.  In addition, "#CP" can be
issued from any environment running in the virtual machine.

CP from the CP environment                                Privilege Class:  Any

Use the CP command as an optional header on commands to CP in a CP environment.
The format of the CP command is:
+----------+------------------------------------------------------------------+
| CP       | [commandline [#commandline2 [#...]]                              |
+----------+------------------------------------------------------------------+
where:

commandline
         specifies the name and operands for the CP command or commands you
         want to issue.  You must precede the first commandline with at least
         one blank.

         The pound sign (#) represents the logical line end symbol currently in
         effect for your virtual machine.  See the CP TERMINAL command to set
         the logical line end symbol.  You can enter multiple command lines as
         operands of the CP command, but you must separate each command line by
         the logical line end (#) symbol.

#CP from any environment                                  Privilege Class:  Any

Use the #CP command to execute a CP command while in a virtual machine command
environment without first signaling attention to get to the CP command
environment.  The format of the CP command is:
+----------+------------------------------------------------------------------+
| #CP      | [commandline [#commandline2 [#...]]                              |
+----------+------------------------------------------------------------------+
where:

commandline
         specifies the name and operands for the CP command or commands you
         want to issue.  You must precede the first commandline with at least
         one blank.

         The pound sign (#) represents the logical line end symbol currently in
         effect for your virtual machine.  See the CP TERMINAL command to set
         the logical line end symbol.  You can enter multiple command lines as
         operands of the CP command, but you must separate each command line by
         the logical line end (#) symbol.

         If you enter #CP without any operands, the virtual machine enters the
         CP environment.  Use the CP command BEGIN to resume execution of the
         virtual machine.

CP from the CMS environment                                 CMS Nucleus command

Use the CP command to transmit commands to the VM/370 control program
environment without leaving the CMS environment.  The format of the CP command
is:
+----------+------------------------------------------------------------------+
| CP       | [FIFO|LIFO|DISCARD] [commandline]                                |
+----------+------------------------------------------------------------------+
where:

FIFO     causes the output of the CP command to be placed in the CMS console
         stack, first-in, first-out.  If the CP command prompts for a password,
         the prompt is not placed in the stack but is displayed.  Any error
         messages produced by the command are surpressed.

LIFO     causes the output of the CP command to be placed in the CMS console
         stack, last-in, first-out.  If the CP command prompts for a password,
         the prompt is not placed in the stack but is displayed.  Any error
         messages produced by the command are surpressed.

DISCARD  causes the output of the CP command to be discarded.  If the CP
         command prompts for a password, the prompt is not discarded but is
         displayed.  Any error messages produced by the command are surpressed.

commandline
         is any CP command valid for your CP command privilege class.  If this
         field is omitted, you are placed in the CP environment and may enter
         CP commands without preceding each command with CP.  To return to CMS,
         issue the CP command BEGIN.


Usage notes:

1.  You must use the CP command to invoke a CP command:
    o  From within a CMS EXEC or an EXEC 2 EXEC.
    o  If the implied CP (IMPCP) function is set to OFF for your virtual
       machine.
    o  In a job that you send to the CMS batch facility.

2.  To enter a CP command from the CMS environment without CMS processing the
    command line, use #CP.

3.  When you enter an invalid CP command following the CP command, you receive
    a return code of -1.  In an EXEC, this return code is +1.

Responses:

All responses are from the CP command that was issued; the CMS ready message
follows the response.