Host Environment Commands › ADDRESS OPSCTL Commands for the MSF › MSF LIST—Return Session Information

MSF LIST—Return Session Information

This command returns information about defined MSF sessions, including session status.

This command has the following format:

ADDRESS OPSCTL "MSF LIST keywords"
  {msfid(sysname|ALL)}
  [FILTPLEX(plexname)]
  [FILTSTAT(A|N)]
  [FILTSUBS(subsys)]
  [FILTSYS(sysname)]
  [SYSTEM(sysid)]
  [SYSWAIT(seconds)]
  [WAIT(seconds)]

MSFID(sysname or ALL)

Specifies the name of the system whose information is to be returned. System names can contain one to eight characters. The first character must be @, #, or $ or an alphabetic character, but the remaining characters can be any alphabetic or national character. If you specify ALL in place of sysname, CA OPS/MVS returns information about all defined sessions.

FILTPLEX (plexname)

(Optional) Defines the sysplex name to be used as a filter.

FILTSTAT(A|N)

(Optional) Returns status information. Specify an A to return information only for remote MSF systems whose connections to the local system are ACTIVE. Specify an N to return information only for remote MSF systems whose connections to the local system are in a status other than ACTIVE.

FILTSUBS(subsys)

(Optional) Defines the CA OPS/MVS subsystem name used to select the remote system. This is useful when there are multiple copies of CA OPS/MVS running on the same remote system.

FILTSYS(sysname)

(Optional) Defines the z/OS SYSNAME as specified in logical parmlib member IEASYSxx used to select the remote MSF system. This is useful when multiple MSF links are defined to a particular system.

SYSTEM, SYSWAIT, and WAIT

(Optional) You may specify the SYSTEM, SYSWAIT, and WAIT keywords described in Keywords Common to ADDRESS OPSCTL MSF Commands in this chapter.

Notes:

• The local system is always excluded when any FILTxxx keyword is specified.
• When multiple FILTxxx keywords are specified, each filter is applied to each remote MSF system.
• FILTSTAT performs filtering on all supported versions of MSF-connected systems.
• Wildcarding on the filters is not supported.