The OPER command sends a z/OS system command execution request to the CA OPS/MVS host. This command enables you to execute authorized z/OS system commands on the remote CA OPS/MVS system and receive the responses. For more information, see the CA OPS/MVS for z/OS Command and Function Reference.
This command has the following format:
ADDRESS OPS "OPER SYSTEM|SYSID}(MSF system name) COMMAND('command text')
[BMPCMDOUT(OPSLOG|WTO|NONE)]
[CAPTURE(msgtext list)]
[CMDECHO(YES|NO)]
[CMDLOG(YES|NO)]
[CMDRESP(destination)]
[CMDWAIT(seconds)]
[{{NAME|CONNAME}(consolename) | [CONTYPE(ANY|EXTCONS|MIGCONS|SSCONS) }]
[IMSID(imsid)]
[IMSREPLY]
[INTERVAL(centiseconds)]
[LOG(YES|NO|OFF)]
[MAXCMDOUT(number)]
[MFORM(J|M)]
[{OUTPUT|NOOUTPUT}]
[PREFIX(newvarname)]
[STOPEND(YES|NO)]
[STOPMSG(msgtextlist)]
[STOPRESP(msgtextlist)]
[SYSWAIT(seconds)]
[WAIT(seconds)]"
Sends the command to the specified OPS system by name as it is defined to the Multi-System Facility (MSF) on a CA OPS/MVS host. You can only specify one CA OPS/MVS system per OPER command.
Note: SYSID and SYSTEM are mutually exclusive synonyms that can be used interchangeably; however, you can only specify one on a single OPER command.
Specifies the z/OS command that is to be executed on a CA OPS/MVS OSF TSO server on the designated MSF system. The command can be any valid z/OS command. The command text can be up to 126 bytes long.
If the command contains keywords, you may need to enclose the COMMAND argument in quotation marks (see the example).
(Optional) Controls the echoing of the current IMS command output.
(Optional) Specifies one to ten message text segments that can be trapped as responses.
(Optional) Captures or omits the command echo.
Default: YES
(Optional) Specifies whether or not to log echo line to SYSLOG.
Default: YES
(Optional) Directs return information to a specific destination (destination). For a description of valid destination values, see ADDRESS OPS Return Information in this chapter.
Default: REXX
(Optional) Conditionally waits up to n seconds for all responses on the CA OPS/MVS system where this command runs. The default for CMDWAIT is specified on the Advanced Settings dialog under CA OPS/MVS Interface in Configuration Manager. The initial value in the dialog for CMDWAIT (when the product is installed) is 10 seconds. For more information, see Waittime Before Timeout in this chapter.
(Optional) Specifies console name to use.
Note: CONNAME and NAME are mutually exclusive synonyms that can be used interchangeably; however, you can only specify one on a single OPER command.
(Optional) Type of console to use on z/OS. Valid values are: ANY, EXTCONS, MIGCONS or SSCONS.
Note: The CONTYPE keyword is mutually exclusive with the CONNAME or NAME keyword.
(Optional) Specifies the IMS ID to send the command to.
(Optional) Causes the current IMS command to be issued using the IMS WTOR instead of the BMP.
(Optional) Amount of time CA OPS/MVS waits to see if a further response is forthcoming. Once two output lines have been received, CA OPS/MVS concludes that the response is complete if this interval expires.
(Optional) Specifies whether or not to log responses to SYSLOG.
Note: Specifying LOG(OFF) is the same as specifying LOG(NO) or CMDLOG(NO).
Default: YES
(Optional) Maximum of n command response lines. The default for MAXCMDOUT is 2000; however, you can change the defaults for all OPER commands by specifying a new default on the Advanced Settings dialog under CA OPS/MVS Interface in Configuration Manager.
(Optional) Specifies format for response output, which must be J or M. For more information, see OPSCMD Command Processor in the CA OPS/MVS for z/OS Command and Function Reference.
(Optional) No response lines will be returned.
Note: NOOUTPUT and OUTPUT are mutually exclusive.
(Optional) Specifies that response lines will be returned. (This is the default.)
Note: NOOUTPUT and OUTPUT are mutually exclusive.
(Optional) Directs return information to a stem variable name (newvarname) other than the default. For more information, see ADDRESS OPS Return Information in this chapter.
Note: The PREFIX operand is only valid if the destination of the return information is REXX.
Default: OPS.OPER
(Optional) Determines whether the end line of a multiline WTO message stops CA OPS/MVS from collecting further responses.
Default: YES
(Optional) Lists one to ten message text segments that terminate the collection of command response lines. When CA OPS/MVS detects any of these text segments, it stops collecting responses. You do not have to direct the message segment(s) that you specify to the console receiving the command response.
(Optional) Lists one to ten message text segments that terminate the collection of command response lines. The message segments that you specify must be directed to the console receiving the command response.
(Optional) CA Automation Point adds n seconds to its overall wait time to account for network delay times incurred communicating with the target CA OPS/MVS host. The default for SYSWAIT is specified on the Advanced Settings dialog under CA OPS/MVS Interface in Configuration Manager. The initial value in the dialog for SYSWAIT (when the product is installed) is 20 seconds. For more information, see the section Waittime Before Timeout.
(Optional) Unconditionally waits up to n seconds for all responses on the targeted CA OPS/MVS system. For more information, see the section Waittime Before Timeout.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|