Host Commands › ADDRESS OPSCTL—Control Components

ADDRESS OPSCTL—Control Components

Use the ADDRESS OPSCTL commands to control the ECF, MSF, COF, and OSF components.

• ECF Component

  ECF LIST

  Returns information about each ECF user logged onto a console.

• MSF Component

  MSF DEFAULT

  Specifies a default system name and system wait value for the currently executing REXX program or rule.

  MSF START

  Tells CA OPS/MVS to initialize the MSF on the local MSF system.

  MSF STOP

  Instructs the local copy of CA OPS/MVS to end its sessions with the remote CA OPS/MVS copies.

• MSF and COF Components

  MSF|COF ACTIVATE

  Causes MSF to activate a VTAM session with MSF on another system.

  Associates a transient data queue and the COF.

  MSF|COF DEACTIVATE

  Ends the MSF session between the local and remote copies.

  Ends the association between a transient data queue and the COF.

  MSF|COF DEFINE

  Defines to the MSF the systems it can communicate with.

  Defines to COF a list of CICS transient data queue names to be selected for AOF processing.

  MSF|COF DELETE

  Deletes MSF or COF defined resources.

  MSF|COF LIST

  Displays all MSF or COF resources currently defined and their status.

  Note: You can permanently add queues to the CICS Operations Facility using ADDRESS OPSCTL COF commands in an AOF rule or an OPS/REXX program.

• OSF Component

  OSF EXECSTATS

  Returns performance information about the OSF server.

  OSF LIST

  Returns information about active servers to the external data queue.

  OSF QUEUES

  Returns status and historical information about the server execution queue to the external data queue.

  OSF RESETQ

  Discards all pending commands waiting on the OSF execute queue.

  OSF STOP nnnn

  Stops the specified server.

• OPSLOG Component

  DEFINE

  Defines a new OPSLOG.

  ACTIVATE

  Makes an OPSLOG active.

  SETLIVE

  Makes a previously active OPSLOG the live log.

  RESET

  Empties an active OPSLOG of data content and resets the message number (MSGNO) back to zeroes. This cannot be the live log.

  LIST

  Lists all defined OPLOGs.

  DEACTIVATE

  Changes the status of a currently activated OPSLOG back to defined.

  DELETE

  Deletes an OPSLOG definition.

Examples: ADDRESS OPSCTL COF Define, Activate, and List Commands

• To create a list of CICS transient data queue names, use the following ADDRESS OPSCTL COF DEFINE command:

  ADDRESS OPSCTL "COF DEFINE keywords"
    JOBNAME(jobname)
  /* optional keywords       */
  STEPNAME(stepname|taskid)
  STATUS
  DESTIDS(destidlist)
  OUTPUT|NOOUTPUT
  SYSTEM(sysname)
  SYSWAIT(seconds)
  

• To add the specified transient data queue names to any destination list that matches the selection criteria, use the following ADDRESS OPSCTL COF ACTIVATE command:

  ADDRESS OPSCTL "COF ACTIVATE keywords"
    JOBNAME(jobname)
  /* optional keywords       */
  STEPNAME(stepname|taskid)
  STATUS(ACTIVE|INACTIVE)
  DESTIDS(destidlist)
  OUTPUT|NOOUTPUT
  SYSTEM(sysname)
  SYSWAIT(seconds)
  

• To display the contents of any transient data destination list that matches the selection criteria, use the following ADDRESS OPSCTL COF LIST command:

  ADDRESS OPSCTL "COF LIST keywords"
    JOBNAME(jobname)
  /* optional keywords       */
  STEPNAME(stepname|taskid)
  STATUS(ACTIVE|INACTIVE)
  OUTPUT|NOOUTPUT
  SYSTEM(sysname)
  SYSWAIT(seconds)
  SUMMARY
  

Example: Define Multiple MSF Links between Systems

The following example defines multiple MSF links between systems. One link uses CA OPS/MVS native APPC session protocol. The second link uses CCI and it's session protocol, which could be XES, XCF, or TCP/IP.

ADDRESS OPSCTL
IF SYSID = OPS11L
THEN DO
  "MSF DEFINE MSFID(OPS11L)   APPLID(A11IOPSL)"       /* local */
  "MSF DEFINE MSFID(OPS31L)   APPLID(A31SENF) CCI"    /* remote CCI */
  "MSF DEFINE MSFID(OPS31LVT) APPLID(A31IOPSL) APPC"  /* remote APPC */
END

IF SYSID = OPS31L
THEN DO
  "MSF DEFINE MSFID(OPS31L)   APPLID(A31IOPSL)"       /* local */
  "MSF DEFINE MSFID(OPS11L)   APPLID(A11SENF) CCI"    /* remote CCI */
  "MSF DEFINE MSFID(OPS11LVT) APPLID(A11IOPSL) APPC"  /* remote APPC */
END

Note: The MSFID for the CCI DEFINE must match the local MSFID for the remote system.