CMS Command

Reference Guide › Command Reference › CMS Command

CMS Command

Use the CMS command to run a CMS subset command, CP command, or EXEC on the CA VM:Secure service virtual machine.

CMS {cmscommand | CP command | EXEC name}

Definition

cmscommand: A CMS subset command (not a user area module).
CP command: A CP command.
EXEC name [parms]: An EXEC, including any necessary parameters to pass to the EXEC.

Description

When the CMS command transmits a CMS subset to CA VM:Secure, the CMS subset active flag is set to prevent the execution of any user area modules. However, the CMS subset environment is not entered, and control always returns to CA VM:Secure following the execution of the specified command.

The CMS command cannot execute a CMS or CP command that attempts a console read; it terminates abnormally if you give it such a command. If you must transmit such a command, build an EXEC that stacks the necessary command or commands before invoking it. For example, if you want to transmit the XEDIT command, build an EXEC that includes a final FFILE or QQUIT, before invoking XEDIT.

If the EXEC interpreter is being invoked, the command must begin with EXEC. CA VM:Secure ignores the IMPEX flag setting.

If you transmit a CP command and the IMPCP flag is off, the command must begin with CP. If the IMPCP flag is on, the command need not begin with CP. CA VM:Secure treats the command first as if it is a CMS command and then a CP command.

Example

To replace the current copy of the USERPASS user exit on the CA VM:Secure 191 A‑disk, do the following:

Send the new copy of the USERPASS user exit to CA VM:Secure by entering:
```
sendfile vmexita exec a vmsecure
```
From a user ID that has the appropriate class privileges, query the CA VM:Secure virtual reader for the user exit’s spool number by entering:
```
query rdr vmsecure
```
CP responds with information about the virtual reader’s contents, including the spool number for the user exit.
Receive the new user exit, from file number 6 in this example, onto the CA VM:Secure service virtual machine’s A‑disk by entering:
```
vmsecure cms exec receive 6 vmxexita exec a (replace
```

Note: For a description of the CMS SET IMPEX command and the CMS SET IMPCP command, see the IBM CMS Commands and Utilities Reference manual for your release of VM.