Previous Topic: DEACTIVATE CommandNext Topic: OPER Command


LIST Command

The LIST command returns a list of nodes that are currently configured on the issuing CA Automation Point workstation.

Note: This command should be used for diagnostic purposes only.

This command has the following format:

ADDRESS OPS "LIST [CMDRESP(destination)] [PREFIX(newvarname)]
   [SYSTEM(MSF system name|ALL)]"
CMDRESP

(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

PREFIX

(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 valid only if the destination of the return information is REXX.

Default: OPS.LIST

SYSTEM

(Optional) Specifies the CA OPS/MVS node name that is defined in the Selected MSF nodes section of the CA‑OPS/MVS Event Traffic Configuration dialog. This name corresponds to the name used by the CA OPS/MVS Multi-System Facility (MSF) to identify itself to CAICCI. You can specify only one CA OPS/MVS system per LIST command.

Note: If this operand is specified, it acts as a filter and returns data only for the specific CA OPS/MVS host.

Default: ALL

Return Information:

The LIST command returns a line of information for each MSF system specified by the SYSTEM operand. Each line contains three fields of information, as described in the following table.

Field

Description

1

Specifies the name of the remote CA OPS/MVS node name that is defined by the MSF facility.

2

Specifies the status of the CA Automation Point to CA OPS/MVS connection.

  • INACTIVE- CA Automation Point is not connected to this CA OPS/MVS node.
  • ACTIVE- CA Automation Point is successfully connected to this CA OPS/MVS node.
  • FAILED- CA Automation Point failed to make a successful connection to this CA OPS/MVS node. Check the ASOTRACE log for more information about the CAICCI connection errors.

Note: If you specify a specific host on the SYSTEM operand, only a single line of output is generated for that host.

3

Specifies the ENF/CCI system name used by CAICCI to identify the z/OS host.

For more information, see the section ADDRESS OPS Return Information.