Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 16 Operator Commands : Commands to Control the CICS Execution Environment

Commands to Control the CICS Execution Environment
The format for TIBCO Object Service Broker CICS operator commands is:
MODIFY cics_jobname,osbcommand
or
F cics_jobname,osbcommand
where
MODIFY or F
Commands
The following table lists the TIBCO Object Service Broker CICS operator commands, describes them, and gives examples of how the commands are entered:
Starts or restarts a CICS Execution Environment and establishes communications with a Data Object Broker.
MODIFY cics_jobname,
HINT TDS=EP01SRV, INSTLIB=BANK03
States whether the specified TIBCO Object Service Broker CICS Execution Environment is attached or detached and lists the number of users, their user IDs, and termids
You can specify HINQ USERC to suppress the listing of users and get only the user count or active sessions.
MODIFY cics_jobname,
HINQ USERC
Cancels the user session specified by the userid/termid. This is the normal method to cancel a user session and should be used before the HFUS transaction described below.
MODIFY cics_jobname,
HCUS userid or termid
WARNING  Use with caution and only when the need to cancel a user session overrides the potential for unpredictable results. Consider restricting access to this Transaction by authorized personnel only by implementing transaction security.
MODIFY cics_jobname,
HFUS userid or termid
Used to display the status of and control the TCP/IP RELAY communications component of TIBCO Object Service Broker within the CICS job.
This component operates independently of any CICS terminal control HCS facility. The RELAY is useful to connect an Eclipse or remote client to the CICS execution environment.
For more information, see the description of the corresponding CS,xxxxxxx RELAY commands in Commands to Control a Data Object Broker. Note that in CICS, the RELAY commands are invoked by the HREL transaction, followed by a space and the RELAY sub-command. The CS, command prefix used for other job environments is not used.
The HREL transaction is designed for use by the CICS z/OS console operator. You may enter the HREL transaction at a CICS terminal, but the response will be displayed on the system console by a WTO.
MODIFY cics_jobname,
HREL DISABLE
MODIFY cics_jobname,
HREL ENABLE
MODIFY cics_jobname,
HREL PARMDSN=
new_dataset_name(member)
Reload parameter file definitions held in parameter file of RELAY:
MODIFY cics_jobname,
HREL REFRESH
MODIFY cics_jobname,
HREL STATUS
Shuts down the TIBCO Object Service Broker CICS Execution Environment without shutting down CICS
SHUT to shut down the Execution Environment when all currently logged in users are logged out. No new users can log in.
SHUTI to immediately terminate the Execution Environment by canceling all logged in users.
MODIFY cics_jobname,
HTRM SHUT
MODIFY cics_jobname,
HTRM SHUTI
SETNUMSERVER=nn, TYPE=API or IMS
Sets the maximum number of external database server sessions that can be started in this CICS environment for the specified server type.
STARTNUMSERVER=nn, TYPE=API or IMS
Starts the specified number of external database server sessions for the specified server type. Corresponding non-terminal CICS transactions as specified by the CICS HURONTRAN=transid Execution Environment parameter are started through the TIBCO Object Service Broker MODIFY commands via the CICS console CONSOLE(0)
STOPNUMSERVER=nn,TYPE=API or IMS
Stops the specified number of external database server sessions for the specified server type.
MODIFY cics_jobname,HSRV SETNUMSERVER=32, TYPE=API
MODIFY cics_jobname,HSRV STARTNUMSERVER=16, TYPE=IMS
MODIFY cics_jobname,HSRV STOPNUMSERVER=16, TYPE=API

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved