IMS Version 9

SET

Format

Read syntax diagramSkip visual syntax diagram>>-SET--APPLID--(VTAM applid)----------------------------------->

>--+-------------------------------+---------------------------><
   +-APPLCOUNT--(max#)-------------+
   +-PASSWORD--(VTAM_ACB_password)-+
   +-INSTANCE--(TMS_instance_name)-+
   '-TIMER--(timer_count)----------'

Usage

The /SET command allows you to specify various parameters that typically stay in effect for the duration of an execution of the transport manager task.

APPLID
Specifies a 1- to 5-character name that becomes the first portion of the series of VTAM APPLIDs used by transport manager and related IMS subsystems. This name also becomes the "system name" of the CPC running this transport manager (used in the naming scheme used by transport manager and users of transport manager).

The name used for the APPLID must match the first portion of the name (specified on the DEFINE SYSTEM command) or the ACBNAME=acbname used for a series of VTAM APPL definition statements. See the IMS Version 9: Installation Volume 2: System Definition and Tailoring.

When transport manager is connected to VTAM (that is, the ACB is open), the APPLID keyword is rejected. To avoid definitional conflicts, SET APPLID must be specified before DEFINE SYSTEM commands are issued.

APPLCOUNT
Specifies the number of VTAM applids that are to be defined to VTAM for use by this transport manager. The number must exceed by at least 1 the maximum number of IMS subsystems ever expected concurrently to execute on this CPC plus the maximum instances of isolated log sender to be started for this transport manager.
PASSWORD
Specifies the VTAM ACB password to be used for the transport manager. This specification is tied to the VTAM APPL PRTCT=password definition. A single password is used for all APPL names.
INSTANCE
Specifies a 1 to 4 character name that becomes the instance name (subsystem id) of this execution of transport manager. This value, combined with the TMI name specified in the DFSRSRxx PROCLIB member, the IMSCTRL macro, the DLIBATCH procedure or the DBBBATCH procedure, allows you to use multiple instances of the transport manager within a single system. With different instances of transport manager, you can run test and production subsystems within the same IMS system.

The default value for the instance name is ELX.

Once the TMS is started, the INSTANCE keyword will be rejected.

TIMER
Specifies the interval, in seconds, to be used for automatic restart of transport-manager-to-transport-manager conversations. Automatic restart attempts are made after conversation failures and are continued until a conversation is established or a STOP SYSTEM or STOP RETRY command is issued.

The default value is 300 seconds.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004