CICS ALTER
Using this command, you can change the attribute values for different CICS resources as documented in the following tables.
Command | Parameters |
|---|---|
CICS ALTER | MAXTASK | ICV | ICVR | CLASSn | TCLASS | SYSTEM | DUMPDS |TCPIPSERVICE| JVMPOOL | DUMPCODE | TDQ | DOCTEMPLATE | IPCONN |TCPIP | WEB | PIPELINE | URIMAP | WEBSERVICE | LIBRARY | TEMPSTORAGE | MQCONN | AUTOINSTALL | DELETSHIPPED | DISPATCHER | ENQMODEL | EVENTPROCESS | IRC | MONITOR | STATISTICS | DB2CONN | DB2ENTRY | DB2TRAN | UOW | UOWLINK |APPLICATION | BUNDLE | EVENTBINDING | FILE |
The following table describes the parameters.
Parameter | Function | Notes |
|---|---|---|
MAXTASK | Specifies the maximum number of tasks, active and suspended, allowed in the CICS address space concurrently 'IMFEXEC CICS ALTER MAXTASK 35' /* Allow only 35 tasks to run */ | For CTS Version 4.2 and earlier, values can be 1 to 999. For CTS Version 5.1 and later, values can be from 10 to 2000. |
ICV | Specifies the region exit interval value in milliseconds 'IMFEXEC CICS ALTER ICV 1000' /*Come back from OS after 1 second*/ | Values can be 100 - 3600000. |
ICVR | Specifies the runaway interval in milliseconds 'IMFEXEC CICS ALTER ICVR 5000' /* If it runs longer than 5 seconds, it is looping */ 'IMFEXEC CICS ALTER ICVR 5000' /* If it runs longer than 5 seconds, it is looping */ | Values can be 500 - 2700000. |
CLASS1 - CLASS10 | Specifies the largest number of tasks in this class that can be active concurrently 'IMFEXEC CICS ALTER CLASS1 10' /* Allow only 10 tasks in this class */ | Values can be 1 - 999. |
TCLASS class MAXACTIVE value | PURGETHRESH value | Resets the maximum number of tasks or the purge threshold for a transaction class 'IMFEXEC CICS ALTER TCLASS DFHTCL05 MAXACTIVE 200' /* Only allow 200 tasks to run */ 'IMFEXEC CICS ALTER TCLASS DFHTCL05 PURGETHRESH 1000' /* Only allow 1000 tasks to queue up */ | Possible attributes and values are Class: This value is any valid 1 - 8 character transaction class name. The word class is not a keyword. It indicates where the positional parameter class name is specified. MAXACTIVE value: Valid values can be 0 - 999. This attribute cannot be specified with PURGETHRESH. After the value for class, specify MAXACTIVE followed by a value. PURGETHRESH value: Valid values can be 0 - 1000000. This attribute cannot be specified with MAXACTIVE. After the value for class, specify PURGETHRESH followed by a value. Only one attribute can be changed per execution of the statement. You cannot change both the MAXACTIVE and the PURGETHRESH attribute with the same statement. |
SYSTEM attribute value Possible attributes are AKP DEBUGTOOL DSALIMIT DSRTPROGRAM DTRPROGRAM DUMPING EDSALIMIT FORCEQR LOGDEFER MAXOPENTCBS MROBATCH PROGAUTOINST PROGAUTOCTLG PROGAUTOEXIT PRTYAGING RUNAWAY SCANDELAY TIME | Issues commands to change certain CICS system attributesAttribute specifies the system attribute and value is the desired value. Example 1: 'IMFEXEC CICS ALTER SYSTEM DUMPING NO' /* This command disallows dumps */ Example 2: IMFEXEC CICS ALTER DEBUGTOOL DEBUG' /* Programs run under debugging tool */ Example 3: 'IMFEXEC CICS ALTER SYSTEM DSALIMIT 8388608' /* Set DSA limit to 8 megabytes*/ Example 4: 'IMFEXEC CICS ALTER DSRTPROGRAM MYROUTER' /* Alter distributed routing program */ Example 5: 'IMFEXEC CICS ALTER SYSTEM EDSALIMIT 500M' /* Set EDSA limit to 500 megabytes */ Example 6: 'IMFEXEC CICS ALTER SYSTEM EDSALIMIT 1G'/* Set EDSA limit to 1 gigabytes */ | Possible attributes and values are AKP: Valid range is 200 - 65535 and specifies the activity keypoint trigger value, which is the number of write requests to the CICS system log stream output buffer between the keypoints. The value 0 is also valid and specifying it turns off keypoints. DEBUGTOOL: Valid values are DEBUG and NODEBUG, which specify that CICS should or should not use debugging profiles to select programs to run under the control of a debugging tool. DSALIMIT: Valid values are 2MB - 16MB. This attribute specifies the maximum amount of dynamic storage area CICS can allocate below the 16 megabyte line. Values can be specified in bytes, kbytes or mbytes by appending K or M to the end of the value, or by leaving a blank for bytes. DSRTPROGRAM: Specify the SYSTEM Distributed Routing Program name. DTRPROGRAM: This attribute specifies the Dynamic Routing program name. DUMPING: Valid values are YES and NO and indicate whether CICS system dumps can be taken. EDSALIMIT: Valid values are 10M - 2G. This attribute specifies the maximum amount of dynamic storage area CICS can allocate above the 16 megabyte line. Values can be specified in bytes, kbytes, mbytes or gbytes by appending K, M or G to the end of the value, or by leaving blank for bytes. FORCEQR: Valid values are FORCE and NOFORCE. This attribute specifies whether you want CICS to force all user application programs specified as CONCURRENCY (THREAD-SAFE) to run under the CICS QR TCB, as if they were specified as CONCURRENCY (QUASIRENT) programs. |
SYSTEM attribute value (Continued) | See the CICS System Programming Reference Guide for more information. Example 7: 'IMFEXEC CICS ALTER SYSTEM LOGDEFER 8' /* Set to 8 milliseconds */ Example 8: 'IMFEXEC CICS ALTER MROBATCH 5' /* Process after 5 batch events */ | LOGDEFER: Specify a value between 0 and 65535 for the SYSTEM LOGDEFER interval value. MAXOPENTCBS: Specify a value between 1 and 999 for the maximum number of open TCBs that can concurrently exist in the CICS region. The MAXOPENTCBS system attribute is available only for CTS Version 4.2 and earlier. MROBATCH: Specify a value between 1 and 255 for the number of batch events that must occur before CICS processes them. PROGAUTOINS: Valid values are ACTIVE and INACTIVE and specify whether automatic installation for programs is to be active or inactive. PROGAUTOCTLG: Valid values are NONE, ALL or MODIFY. This attribute specifies which automatically installed program definitions are to be cataloged and when. Definitions are to be cataloged only when modified. PROGAUTOEXIT: This attribute specifies the name of the user-provided program to be called by the CICS program autoinstall code to provide a model definition. PRTYAGING: Valid values are between 0 and 65535 (in milliseconds). This attribute specifies the rate at which CICS is to increase the priority of a task waiting for dispatch. RUNAWAY: Valid values are between 500 and 2700000 (in milleseconds). This attribute specifies the default for runaway task time. SCANDELAY: Valid values are 0 to 5000 (in milliseconds). This attribute specifies the maximum number of milliseconds between a user task making a terminal I/O request and CICS dispatching the terminal control task to process it. TIME: Valid values are in the range 100 - 3600000. This attributes specifies the maximum interval in milliseconds for which CICS gives control to the operating system if no tasks are ready for dispatch. Only one attribute can be changed per execution of the statement. You will need to code multiple statements in order to change multiple attributes. |
DUMPDS attribute value Possible attributes are as follows: DATASET INITIALDDS OPENSTATUS SWITCHSTATUS | Changes the attributes of the CICS dump data set Example 1: 'IMFEXEC CICS ALTER DUMPDS OPENSTATUS OPEN' /* This command opens the active dump data set */ Example 2: 'IMFEXEC CICS ALTER DUMPDS INITIALDDS AUTO' /* Next warm start use whichever data set not used last */ | Possible attributes and values are as follows: DATASET: Valid values are A and B and specify the current dump data set. INITIALDDS: This attribute specifies which dump data set is to be active first on subsequent warm or emergency restarts. Valid values are A, B and AUTO. AUTO indicates to use the data set that was not active when CICS last terminated (normally or abnormally). OPENSTATUS: Valid values are OPEN and CLOSE. This attribute specifies the actions to be taken on the transaction dump data sets. SWITCHSTATUS: Valid values are NO and NEXT. This attribute specifies whether CICS is to switch active data sets automatically the next time the current dump data set fills up. |
TCPIPSERVICE serviceAttribute value Possible attributes are BACKLOG DNSSTATUS STATUS URM | Modifies the status of a service by using CICS internal TCP/IP support Example 1: 'IMFEXEC CICS ALTER TCPIPSERVICE PRINTER STATUS CLOSED' /* Close printer service */ | Possible attributes and values are BACKLOG: This attribute changes the maximum number of requests that can be queued in TCP/IP waiting to be processed by the service. Specify service name followed by BACKLOG followed by value. DNSSTATUS: Valid value is DEREGISTERED. This attribute changes the Domain Name System (DNS)/Workload Manager (WLM) registration status of this service. Specify service name followed by DNSSTATUS followed by value. STATUS: Valid values are OPEN, CLOSED and IMMCLOSE. This attribute changes the status of the service. Specify service name followed by STATUS followed by value. URM: This attribute specifies the 8-character name of the program to be used as the Service User-replaceable module. Specify service name followed by URM followed by value. |
JVMPOOL attribute value Possible attributes are STATUS TERMINATE | Enables or disables the JVM pool, or terminate the pool altogether Example 1: 'IMFEXEC CICS ALTER JVMPOOL STATUS DISABLED' /* No new requests are allowed */ Example 2: 'IMFEXEC CICS ALTER JVMPOOL TERMINATE PURGE' /*Purge all the tasks */ | Possible attributes and values are STATUS: Valid values are ENABLED and DISABLED. This attribute specifies whether new Oracle Java requests can be accepted and serviced by the JVM pool. TERMINATE: Valid values are PHASEOUT, PURGE and FORCEPUR. This attribute specifies that the JVM pool is to be terminated. ALTER JVMPOOL is available only for CTS Version 4.2 and later. |
DUMPCODE type name | Issues commands to change certain attributes of system and transaction level dump codes in CICS Type specifies SYSTEM or TRAN, and name specifies the name of your dump code. Example 1: 'IMFEXEC CICS ALTER DUMPCODE SYSTEM AP0001 SHUTDOWN YES'/* Shut down the system when this abend code occurs */ Example 2: 'IMFEXEC CICS ALTER DUMPCODE TRAN ASRA MAXIMUM 200' /* Set the maximum number of dumps with this code to be taken */ Example 3: 'IMFEXEC CICS ALTER DUMPCODE TRAN AZCT SCOPE RELATED'/* Dump other CICS’ in SYSPLEX that are connected to this region with the same UOW */ Example 4: 'IMFEXEC CICS ALTER DUMPCODE SYSTEM AP0001 DAE YES' /* The dump is eligible for dump suppression */ | Possible attribute and values are RESET: Reset to zero the number of dumps taken for this dump code. No further parameters are necessary. SHUTDOWN value: Specify YES or NO to indicate whether the CICS region should shut down after request for a dump with this code. MAXIMUM value: Specify the maximum number of dumps to be taken for this dump code. Value can be a number between 0 and 999. SCOPE value: Specify whether a request for a dump with this dump code should cause CICS to initiate requests for SDUMPs (system dumps) of 'related' CICS regions. Valid values are RELATED and LOCAL. SYSDUMP value: Specify whether a system dump request with this code should produce a dump. Valid values are YES and NO. TRANDUMP value: Specify whether a transaction dump should be taken when a transaction dump request with this code is received. Valid values are YES and NO. This parameter is valid for transaction dump codes only. DAE value: Specify whether a dump produced for this dump code is eligible for suppression by the MVS Dump Analysis and Elimination (DAE) component. Valid values are YES and NO. This parameter is valid for system dump codes only. |
TDQ queueName attribute value Possible attributes are as follows: ATIFACILITY ATITERMID ATITRANID ATIUSERID TRIGGERLEVEL | Alters the attributes of a CICS Transient Data Queue Example 1: 'IMFEXEC CICS ALTER TDQ QUE1 ATIFACILITY TERMINAL' /* QUE1 has a terminal as principal facility */ Example 2: 'IMFEXEC CICS ALTER TDQ QUE1 ATITERMID T001'/* Associate terminal T001 with queue QUE1 */ Example 3: 'IMFEXEC CICS ALTER TDQ QUE2 ATITRANID TRX2'/* Transaction TRX2 should run for ATI */ Example 4: 'IMFEXEC CICS ALTER TDQ QUE3 ATIUSERID USR3'/* User USR3 is associated with queue QUE3 */ Example 5: 'IMFEXEC CICS ALTER TDQ QUE1 TRIGGERLEVEL 2'/* Kick off transaction when 2 items are on the queue */ | Possible attributes and values are as follows: ATIFACILITY values can be TERMINAL or NOTERMINAL This command specifies whether the queue has a terminal associated with it and applies to intrapartition queues only. ATITERMID specifies a 4-character terminal or session associated with the queue. This command applies to Intrapartition queues only. ATITRANID specifies a 4-character transaction ID to be executed when CICS initiates a task automatically to process the queue. This command applies to Intrapartition queues only. ATIUSERID specifies an 8-byte user ID to be associated with the queue. This command applies to Intrapartition queues only. TRIGGERLEVEL valid values are0 - 32766. This command specifies the number of items that must be on the queue in order for the Automatic Transaction Initiation (ATI) to take place and applies to Intrapartition queues only. |
DOCTEMPLATE name attribute value Possible attributes are as follows: COPY | Alters attributes of a Document Template using the EXEC CICS SET DOCTEMPLATE command. Example 1: 'IMFEXEC CICS ALTER DOCTEMPLATE doctemp1 COPY NEWCOPY' /* NEWCOPY template doctemp1 */ | Possible attributes and values are: COPY NEWCOPY is the only valid value. Valid only for CTS Version 3.2 and later. |
IPCONN name attribute value Possible attributes are as follows: CONNSTATUS PENDSTATUS PURGETYPE RECOVSTATUS SERVSTATUS UOWACTION | Alters attributes of a Document Template using the EXEC CICS SET IPCONN command. Example 1: 'IMFEXEC CICS ALTER IPCONN ipconn01 CONNSTATUS RELEASED' /* Release the session */ Example 2: 'IMFEXEC CICS ALTER IPCONN ipconn01 PENDSTATUS NOTPENDING' /* Force commit or backout */ Example 3: 'IMFEXEC CICS ALTER IPCONN ipconn01 PURGETYPE CANCEL' /* Cancel queued requests */ Example 4:'IMFEXEC CICS ALTER IPCONN ipconn01 RECOVSTATUS NORECOVDATA' /* Override resync */ Example 5:'IMFEXEC CICS ALTER IPCONN ipconn01 SERVSTATUS OUTSERVICE' /* Set it out of service */ Example 6:'IMFEXEC CICS ALTER IPCONN ipconn01 UOWACTION RESYNC' /* Attempt retry */ | Possible attributes and values are: CONNSTATUS Valid values are ACQUIRED or RELEASED. PENDSTATUS NOTPENDING is the only valid value. PURGETYPE Valid values are CANCEL, FORCECANCEL, FORCEPURGE, KILL, and PURGE. RECOVSTATUS NORECOVDATA is the only valid value. SERVSTATUS Valid values are INSERVICE and OUTSERVICE. UOWACTION Valid values are BACKOUT, COMMIT, FORCE, and RESYNC. Valid only in CTS Version 3.2 and later. |
TCPIP Possible attributes are as follows: MAXSOCKETS OPENSTATUS | Alters CICS TCP/IP resources Example 1: 'IMFEXEC CICS ALTER TCPIP MAXSOCKETS 1024' /* Set maximum sockets */ | Possible attributes and values are as follows: MAXSOCKETS: Specify a value between 1 and 65535 that controls the number of IP sockets that will be managed by the CICS sockets domain. |
Example 2: 'IMFEXEC CICS ALTER TCPIP OPENSTATUS OPEN'/* Open it up */ | OPENSTATUS: Valid values are OPEN, CLOSED, or IMMCLOSE which specify the TCPIP OPENSTATUS for the CICS region. | |
WEB Possible attributes are as follows: GARBAGEINT TIMEOUTINT | Alters attributes of CICS WEB resources Example 1: 'IMFEXEC CICS ALTER WEB GARBAGEINT 5'/* Run cleanup every 5 minutes */ | Possible attributes and values are as follows: GARBAGEINT: Specify a value between 1 and 6000 minutes, after which garbage collection runs to clean up WEB 3270 state data. |
Example 2: 'IMFEXEC CICS ALTER WEB TIMEOUTINT 5'/* Run cleanup every 5 minutes */ | TIMEOUTINT: Specify a value between 1 and 60 minutes, after which WEB 3270 sessions are eligible for garbage collection. | |
PIPELINE [pipename] Possible attributes are as follows: ENABLESTATUS RESPWAIT | Specifies a pipename value and a status or wait value Example 1: 'IMFEXEC CICS ALTER PIPELINE mypipe1 ENABLESTATUS ENABLED'/* Enable the PIPELINE */ | Possible attributes and values are as follows: ENABLESTATUS: Specify a pipename and an ENABLE status; valid values are ENABLED or DISABLED. |
Example 2: 'IMFEXEC CICS ALTER PIPELINE mypipe1 RESPWAIT 10'/* Allow 10 seconds for the response to return*/ | RESPWAIT: Specify a pipename and a wait value between 0 and 9999 seconds that an application program should wait for a response message from a remote WEB server. | |
URIMAP [urimapname] Possible attributes are as follows: ENABLESTATUS REDIRECTTYPE LOCATION | Specifies a urimapname value Example 1: 'IMFEXEC CICS ALTER URIMAP myurimap ENABLESTATUS ENABLED' /* Enable the URIMAP */ | Possible attributes and values are as follows: ENABLESTATUS: Specify a urimapname and an ENABLE status; valid values are ENABLED or DISABLED. |
Example 2: 'IMFEXEC CICS ALTER URIMAP myurimap REDIRECTTYPE PERMANENT'/* Make the change permanent */ | REDIRECTTYPE: Specify a urimapname and a redirect value for requests that match the URIMAP definition. Using this attribute might require that the URIMAP location has been previously set. Valid values are NONE, TEMPORARY, or PERMANENT. | |
LOCATION: Specify a URL name up to 255 characters long where HTTP requests for the URIMAP should be redirected. | ||
WEBSERVICE name Possible attributes: VALIDATIONST | Alters the status of an installed WEBSERVICE Example: 'IMFEXEC CICS ALTER WEBSERVICE WEBSERV1 VALIDATIONST VALIDATION' /* Fully validate WEBSERV1 */ | Possible attributes and values are as follows: name: Specify an up to 32-character WEBSERVICE resource name. VALIDATIONST: Specify whether full validation is enabled for the WEBSERVICE resource or not. Valid values are VALIDATION and NOVALIDATION. |
LIBRARY libraryName Possible attributes: ENABLESTATUS CRITICALST RANKING | Alters the attributes of a library resource Example: 'IMFEXEC CICS ALTER LIBRARY STOCKAPS CRITICALST CRITICAL' /* The STOCKAPS library is critical */ | Possible attributes and values are: ENABLESTATUS: Specify whether the library will be included in the overall search order. Valid values are ENABLED and DISABLED. CRITICALST: Specify whether the library is critical to the startup of CICS. Valid values are CRITICAL and NONCRITICAL. RANKING: Specify a value from 1 - 99 which specifies where this LIBRARY appears in the overall LIBRARY search order, relative to other LIBRARY concatenations. |
TEMPSTORAGE Possible attributes: TSMAINLIMIT | Alters the amount of storage available for temporary storage queues. Example: 'IMFEXEC CICS ALTER TEMPSTORAGE TSMAINLIMIT 128' /* Change temp storage to 128M */ | Possible attributes and values are: TSMAINLIMIT: Specify the number of megabytes in the range 1 - 32767. |
MQCONN qmID | Alters information about the attributes of the connection between CICS and MQ and start or stop the connection. Example: 1 'IMFEXEC CICS ALTER MQCONN CSQ1 MQNAME CSQ2' /* Connect to csq2 */ Example: 2 'IMFEXEC CICS ALTER MQCONN CSQ1 CONNECTST NOTCONNECTED' /* Stop the connection */ 'IMFEXEC CICS ALTER MQCONN CSQ1 CONNECTST NOWAIT' /* Quiesce the connection and wait for transactions to end */ | Possible attributes and values are: Qmid: 1 to 4-character queue manager ID (always required). CONNECTST: Starts or stops the connection between CICS and IBM MQ. Valid values are CONNECTED and NOTCONNECTED, FORCE, NOWAIT or WAIT. Specifying FORCE, NOWAIT or WAIT causes CONNECTST to be NOTCONNECTED along with the specified value of FORCE, NOWAIT or WAIT. RESYNCMEMBER: Specify the strategy that CICS adopts when there are outstanding units of work for the last queue manager where CICS was connected from the queue-sharing group. Valid values are RESYNC, NORESYNC and GROUPRESYNC. GROUPRESYNC is valid only for CICS Version 4.2 and later. MQNAME: 1 to 4-character queue manager ID that specifies the queue manager to which CICS is to connect. |
AUTOINSTALL | Alters AutoInstall values. Example 1: 'IMFEXEC CICS ALTER AUTOINSTALL CONSOLES FULLAUTO' /* Only CICS handles Autoinstalls of consoles */ | Possible attributes and values are: AIBRIDGE: Specify whether the AutoInstall User Replaceable Module is called for bridge facilities. Valid values are AUTOTERMID and URMTERMID. CONSOLES: Specify whether CICS autoinstalls an MVS console when it receives an MVS MODIFY command from a console that is not defined. Valid values are PROGAUTO, FULLAUTO and NOAUTO. MAXREQS: Specify the largest number of autoinstall requests CICS can concurrently process. Valid values are from 0 - 999. PROGRAM: Specify an 8-character name to be used in the autoinstall process for terminals. |
DELETSHIPPED | Alters the values that control the deletion of shipped terminals. Example 1: 'IMFEXEC CICS ALTER DELETSHIPPED IDLE 000500'/* Make eligible for deletion after 5 minutes idle */ Example 2: 'IMFEXEC CICS ALTER DELETSHIPPED INTERVAL 30' /* Check for eligible deletes every 30 seconds */ | Possible attributes and values are: IDLE: Specify a time value in the format <hhmmss>. The valid range of values for hh are 00 - 99; the valid values for mm are 00 - 59; the valid values for ss are 00 - 59. Leading zeros can be omitted. INTERVAL: Specify a time value in the format <hhmmss>. The valid range of values for hh are 00 - 99; the valid values for mm are 00 - 59; the valid values for ss are 00 - 59. Leading zeros can be omitted. |
DISPATCHER | Alters the dispatcher system information. Example 1: 'IMFEXEC CICS ALTER DISPATCHER MAXJVMTCBS 200' /* Set max number of J8 and J9 Mode Open TCBS Active */ Example 2: 'IMFEXEC CICS ALTER DISPATCHER MAXXPTCBS 200' /* Set max number of X8 and X9 Mode Open TCBS Active */ Example 3: 'IMFEXEC CICS ALTER DISPATCHER MAXSSLTCBS 200' /* Set max number of S8 Mode Open TCBs active */ | Possible attributes and their values are: MAXJVMTCBS: Specify a numeric value in the range 1 - 999. This attribute is available only in CTS Version 4.2 and earlier. MAXXPTCBS: Specify a numeric value in the range 1 - 999. This attribute is available only in CTS Version 4.2 and earlier. MAXSSLTCBS: Specify a numeric value in the range 1 - 1024. |
ENQMODEL name | Alters the status of an ENQMODEL definition. Example: 'IMFEXEC CICS ALTER ENQMODEL NQMDLPR1 STATUS DISABLED' /* Set NQMDLPR1 disabled */ | Possible attributes and their values are: Name: Specify the 8-character ID of the resource definition. STATUS: Valid values are ENABLED and DISABLED. |
EVENTPROCESS | Alters the status of event processing. Example: 'IMFEXEC CICS ALTER EVENTPROCESS EPSTATUS STARTED' /* Change event process state to started */ | Possible attributes and their values are: EPSTATUS: Valid values are STARTED, STOPPED and DRAIN. |
IRC | Alters the status of interregion communication. Example: 'IMFEXEC CICS ALTER IRC OPENSTATUS CLOSED' /* Close interregion comm. */ | Possible attributes and their values are: OPENSTATUS: OPEN, CLOSED or IMMCLOSE |
MONITOR | Alters CICS monitoring options. Example 1: 'IMFEXEC CICS ALTER MONITOR FREQUENCY 040000' /* Produce records every 4 hours */ Example 2: 'IMFEXEC CICS ALTER MONITOR DPLLIMIT 40' /* Monitor up to 40 */ | Possible attributes and their values are: COMPRESSST: Valid values are COMPRESS and NOCOMPRESS. FREQUENCY: Specify a time value in the format hhmmss. The value must be in the range of 1 minute to 24 hours. The hh value can be 00 to 24 but 24 is allowed only if mm and ss are 00. The values for mm and ss cannot exceed 59. CONVERSEST: Valid values are CONVERSE and NOCONVERSE. IDNTYCLASS: Valid values are IDNTY and NOIDNTY. RESRCECLASS: Valid values are RESRCE and NORESRCE. SYNCPOINTST: Valid values are SYNCPOINT and NOSYNCPOINT. DPLLIMIT: Specify a numeric value in the range 0 - 64. FILELIMIT: Specify a numeric value in the range 0 - 64. TSQUEUELIMIT: Specify a numeric value in the range 0 - 64. |
STATISTICS | Alters the statistics recording settings of CICS. Example 1: 'IMFEXEC CICS ALTER STATISTICS RECORDING ON' /*Record interval statistics */ Example 2: 'IMFEXEC CICS ALTER STATISTICS RESETNOW' /* Reset statistics counters to initial values */ Example 3: 'IMFEXEC CICS ALTER STATISTICS RESETRECORDNOW' /* Switch the recording status and set RECORDNOW and RESETNOW * | Possible attributes and their values are: RECORDING: Valid values are ON and OFF. INTERVAL: Specify a time value in the format hhmmss (must be in the range 000001 to 240000) ENDOFDAY: Specify a time value in the format hhmmss (must be in the range 000000 to 235959 local time) RECORDNOW: Immediately writes current statistics to a data set or a dataspace and switches RECORDING status from ON to OFF or OFF to ON, depending on current status. RESETNOW: Immediately writes current statistics to a data set or a dataspace, resets statistics counters to their initial values and switches RECORDING status from ON to OFF or OFF to ON, depending on current status. RESETRECORDNOW: Writes current statistics immediately, resets statistics counters to their initial values, and switches RECORDING status from ON to OFF or from OFF to ON, depending on current status. |
DB2CONN connectionID | Alters the attributes of the CICS DB2 connection. Example 1: 'IMFEXEC CICS ALTER DB2CONN DB2A CONNECTERROR ABEND' /* Abend if not connected */ Example 2: 'IMFEXEC CICS ALTER DB2CONN DB2A COMTHREADLIM 200' /* Set max number of command threads */ Example 3: 'IMFEXEC CICS ALTER DB2CONN DB2A MSGQUEUE1 Q001' /* Set TDQ ID for first queue for unsolicited messages */ Example 4: 'IMFEXEC CICS ALTER DB2CONN DB2A TCBLIMIT 100' /* Set limit for DB2 requests */ | Possible attributes and their values are: SECURITY: Valid value is REBUILD. ACCOUNTREC: Valid values are NONE, TXID, TASK and UOW. AUTHID: Specify an 8-character name. AUTHTYPE: Valid values are GROUP, SIGN, TERM, TX, OPID and USERID. COMAUTHID: Specify an 8-character name. COMAUTHTYPE: Valid values are CGROUP, CSIGN, CTERM, CTX, COPID and CUSERID. COMTHREADLIM: Specify a numeric value in the range 1 - 2000. CONNECTERROR: Valid values are ABEND and SQLCODE. CONNECTST: Valid values are CONNECTED, NOTCONNECTED, WAIT and FORCE. WAIT and FORCE both cause the CONNECTST to be NOTCONNECTED along with the use of the BUSY(WAIT|FORCE) parameter. DB2GROUPID: Specify a 4-character name of a data-sharing group. DB2ID: Specify a 4-character name of a DB2 subsystem. |
DB2CONN connectionID (continued) | MSGQUEUE1,MSGQUEUE2, MSGQUEUE3: Specify a 4-character TDQ name. NONTERMREL: Valid values are RELEASE and NORELEASE. PLAN: Specify an 8-character name of the plan to be used. PLANEXITNAME: Specify an 8-character plan exit name. PRIORITY: Valid values are HIGH, LOW and EQUAL. PURGECYCLEM: Specify a numeric value in the range 00 - 59. PURGECYCLES: Specify a numeric value in the range 00 - 59. RESYNCMEMBER: Valid values are RESYNC and NORESYNC. REUSELIMIT: Specify a numeric value in the range 0 - 10000 SIGNID: Specify an 8-character authorization ID. STANDBYMODE: Valid values are CONNECT, NOCONNECT and RECONNECT. STATSQUEUE: Specify a 4-character TDQ name. TCBLIMIT: Specify a numeric value in the range 4 - 2000. THREADLIMIT: Specify a numeric value in the range 3 - 2000. THREADWAIT: Valid values are TWAIT and NOTWAIT. | |
DB2ENTRY entryName | Changes the attributes of a specific DB2ENTRY Resource. Example 1: ''IMFEXEC CICS ALTER DB2ENTRY DB2ENT01 ACCOUNTREC NONE' /* No accounting records required */' Example 2: 'IMFEXEC CICS ALTER DB2ENTRY DB2ENT02 AUTHTYPE TERM' /* Use the terminal ID for authorization */ Example 3: 'IMFEXEC CICS ALTER DB2ENTRY DB2ENT03 ENABLESTATUS ENABLED' /* Make this entry available */ Example 4: 'IMFEXEC CICS ALTER DB2ENTRY DB2ENT03 ENABLESTATUS WAIT' /* Disable and get control after entry is disabled */ | Possible attributes and their values are: entryName: Specify an 8-character DB2entry name. ACCOUNTREC: Valid values are NONE, TXID, TASK and UOW. AUTHID: Specify an 8-character name used for security checking. Mutually exclusive with AUTHTYPE. AUTHTYPE: Valid values are GROUP, SIGN, TERM, TX, OPID and USERID. DISABLEDACT: Valid values are POOL, ABEND and SQLCODE. ENABLESTATUS: Valid values are ENABLED, DISABLED, WAIT and FORCE. When DISABLED is specified, the BUSY(NOWAIT) is also used. When WAIT or FORCE is used, BUSY(WAIT) is also used. PLAN: Specify an 8-character PLAN name. Mutually exclusive with PLANEXITNAME. PLANEXITNAME: Specify an 8-character exit name. Mutually exclusive with PLAN. PRIORITY: Valid values are HIGH, LOW and EQUAL. PROTECTNUM: Specify a numeric value in the range 0 - 2000. THREADLIMIT: Specify a numeric value in the range 0 - 2000. THREADWAIT: Valid values are TWAIT, NOTWAIT and TPOOL. |
DB2TRAN db2entry | Alter the attributes of a particular DB2TRAN associated with a DB2ENTRY. Example 1: 'IMFEXEC CICS ALTER DB2TRAN DB2PRIO1 TRANSID TR01' /* Set TR01 as the db2tran for the db2entry DB2PRIO1 */ Example 2: 'IMFEXEC CICS ALTER DB2TRAN DB2PRIO2 DB2ENTRY DB2ENT01' /* Assign DB2PRIO2 to entry DB2ENT01 */ | Possible attributes and their values are: db2entry: Specify an 8-character DB2ENTRY name to which this command applies. TRANSID: Specify a 4-character transaction ID. DB2ENTRY: Specify an 8-character DB2ENTRY ID. |
UOW uow | Commit, back out or force a shunted unit of work. Example: 'IMFEXEC CICS ALTER UOW CB1116B680A97850 UOWSTATE COMMIT' /* Try to force syncpoint COMMIT processing */ | Possible attributes and their values are: uow: Specify a 16-byte value. UOWSTATE: Valid values are BACKOUT, COMMIT and FORCE. |
UOWLINK token | Delete the link to a unit of work that was created by a connection that has since been discarded. Example: 'IMFEXEC CICS ALTER UOWLINK 0101001A ACTION DELETE' /* Delete the link */ | Possible attributes and their values are: token: Specify a 4-byte value. ACTION: Valid value is DELETE. |
APPLICATION name Possible attributes are: AVAILSTATUS ENABLESTATUS | Alter the status of an APPLICATION Example: “IMFEXEC CICS ALTER APPLICATION platform/appl_name/nn/nn/nn ENABLESTATUS ENABLED” /* Enable platform/appl_name/nn/nn/nn */ | Possible attributes and values are: name: Specifies the name of an APPLICATION. The application name must be preceded by the Platform name and a slash ('/'). AVAILSTATUS: Changes the status of an APPLICATION resource. Valid values are AVAILABLE and UNAVAILABLE. ENABLESTATUS: Changes the status of an APPLICATION resource. Valid values are ENABLED and DISABLED. |
BUNDLE name Possible attributes are: AVAILSTATUS ENABLESTATUS COPY | Alter the status of a BUNDLE resource Example 1: 'IMFEXEC CICS ALTER BUNDLE FileEnableEventBundle AVAILSTATUS AVAILABLE' /* Enable the bundle */ Example 2: 'IMFEXEC CICS ALTER BUNDLE $9834776 COPY PHASEIN' /* Bring in newest version */ newest version */ | Possible attributes and values are: AVAILSTATUS: Changes the status of a BUNDLE resource. Valid values are AVAILABLE and UNAVAILABLE. ENABLESTATUS: Changes the status of a BUNDLE resource. Valid values are ENABLED and DISABLED. COPY: The only valid value is PHASEIN, which determines the highest semantic version of all OSGi bundles in the bundle's root directory and registers that version with the OSGi framework, if not already registered. |
EVENTBINDING Possible attributes: ENABLESTATUS | Alter the status of an EVENTBINDING resource Example: 'IMFEXEC CICS ALTER EVENTBINDING DB2ConnectEventBinding.evbind DISABLED' /* Disable the DB2 Event Binding */ | Possible attributes and values are: ENABLESTATUS: Changes the status of an EVENTBINDING resource. Valid values are ENABLED and DISABLED. |
FILE name The possible attributes are: ADD BROWSE CFDTPOOL DELETE DISPOSITION EMPTYSTATUS ENABLESTATUS EXCLUSIVE | Alter attributes and status of a file Example 1: 'IMFEXEC CICS ALTER FILE STOCK ADD ADDABLE' /* Allow records to be added */ Example 2: 'IMFEXEC CICS ALTER FILE STOCK BROWSE BROWSABLE' /* Allow records to be browsed */ Example 3: 'IMFEXEC CICS ALTER FILE CFDATA01 CFDTPOOL CFPOOL01' /* Specify the pool */ Example 4: 'IMFEXEC CICS ALTER FILE STOCK DELETE DELETABLE' /* Allow records to be deleted */ Example 5: 'IMFEXEC CICS ALTER FILE STOCK DISPOSITION OLD' /* Need exclusive access */ Example 6: 'IMFEXEC CICS ALTER FILE STOCK EMPTYSTATUS NOEMPTYREQ' /* Keep dataset intact */ Example 7: 'IMFEXEC CICS ALTER FILE STOCK ENABLESTATUS DISABLED' /* Disable the file */ Example 8: 'IMFEXEC CICS ALTER FILE BDAMFILE EXCLUSIVE EXCTL' /* Exclusive control */ | Alter an attribute of a FILE. Notes: Keywords and possible values are as follows. Specify one keyword and its value. ADD: Specifies whether new records can be added to the file. Valid values are ADDABLE and NOTADDABLE. BROWSE: Specifies whether the file can be browsed. Valid values are BROWSABLE and NOTBROWSABLE. CFDTPOOL: Specify an up to 8-character value of the pool containing the Coupling Facility Data Table. DELETE: Specifies whether records can be deleted from the file. Valid values are DELETABLE and NOTDELETABLE. DISPOSITION: Specifies a disposition for the file. Valid values are OLD and SHARE. EMPTYSTATUS: Specifies whether a dataset is to be emptied when a file that refers to it is next opened. Valid values are EMPTYREQ and NOEMPTYREQ. ENABLESTATUS: Specifies whether applications can access the file. Valid values are ENABLED, DISABLED, FORCED and NOWAIT. FORCED is DISABLED with a force. NOWAIT is DISABLED with no wait. EXCLUSIVE: Specifies whether records are placed under exclusive control when a read or update is issued. Valid values are EXCTL and NOEXCTL. |
FILE name The possible attributes are (continued): KEYLENGTH LOADTYPE LSRPOOLNUM MAXNUMRECS OPENSTATUS READ READINTEG RECORDSIZE RLSACCESS STRINGS | Example 9: 'IMFEXEC CICS ALTER FILE CFDATA01 KEYLENGTH 16' /* Set key length to 16 */ Example 10: 'IMFEXEC CICS ALTER FILE CFDATA01 LOADTYPE LOAD' /* Pre-load from source */ Example 11: 'IMFEXEC CICS ALTER FILE STOCK LSRPOOLNUM 255' /* Use pool 255 */ Example 12: 'IMFEXEC CICS ALTER FILE STOCK MAXNUMRECS 9999' /* Less than 10,000 records */ Example 13: 'IMFEXEC CICS ALTER FILE STOCK OPENSTATUS CLOSED' /* Close the file */ Example 14: 'IMFEXEC CICS ALTER FILE STOCK READ READABLE' /* Make the records readable */ Example 15: 'IMFEXEC CICS ALTER FILE STOCK READINTEG REPEATABLE' /* Read integrity required */ Example 16: 'IMFEXEC CICS ALTER FILE CFDATA01 RECORDSIZE 32767 ' /* Set to max recordsize */ Example 17: 'IMFEXEC CICS ALTER FILE STOCK RLSACCESS RLS ' /* Set RLS mode */ Example 18: 'IMFEXEC CICS ALTER FILE STOCK STRINGS 255 ' /* Maximum concurrent strings */ | KEYLENGTH: Specifies the key length of records in a coupling facility data table. Specify a value between 1 and 16. LOADTYPE: Specifies whether the coupling facility data table associated with the file requires pre-loading from a source dataset. Valid values are LOAD and NOLOAD. LSRPOOLNUM: Specifies the number of the LSR pool associated with this file. Specify a value between 1 and 16 for CTS version 4.1 and a value between 1 and 255 for CTS version 4.2 and later. MAXNUMRECS: Specifies the maximum number of records that the data table for this file can hold. Specify a value between 1 and 9999999. OPENSTATUS: Specifies whether the file is open or closed. Valid values are OPEN, CLOSED, FORCED and NOWAIT. FORCED is CLOSED with a force. NOWAIT is CLOSED with no wait. READ: Specifies whether records can be read from the file. Valid values are READABLE and NOTREADABLE. READINTEG: Specifies the default level of read integrity for the file. Valid values are CONSISTENT, REPEATABLE and UNCOMMITED. RECORDSIZE: Specifies the maximum record size for a coupling facility data table. Specify a value between 1 and 32767. RLSACCESS: Specifies whether the file is to be accessed in RLS mode. Valid values are RLS and NOTRLS. STRINGS: Specifies the maximum number of concurrent operations to allow on this file. Specify a value between 1 and 255. |
FILE name The possible attributes are (continued): TABLE TABLENAME UPDATE UPDATEMODEL DSNAME | Example 19: 'IMFEXEC CICS ALTER FILE STOCK TABLE NOTTABLE ' /* Not a data table */ Example 20: 'IMFEXEC CICS ALTER FILE CFDATA01 TABLENAME CFDTATM7 ' /* Set table name */ Example 21: 'IMFEXEC CICS ALTER FILE STOCK UPDATE UPDATABLE ' /* The file is read/write */ Example 22: 'IMFEXEC CICS ALTER FILE CFDATA01 UPDATEMODEL LOCKING ' /* Records locked for update */ Example 23: 'IMFEXEC CICS ALTER FILE STOCK DSNAME STK0735.V250 ' /* Set data set name */ | TABLE: Specifies whether the file name specified on the FILE parameter represents a data table. Valid values are CFTABLE, CICSTABLE, NOTTABLE and USERTABLE. TABLENAME: Specifies a 1 to 8-character name of the coupling facility data table to which this file refers. UPDATE: Specifies whether the file is read-only or read/write. Valid values are UPDATABLE and NOTUPDATABLE. UPDATEMODEL: Specifies the type of update coupling facility data table used for a coupling facility data table. Valid values are CONTENTION and LOCKING. DSNAME: Specifies the data set name of the data set associated with this file. Specify up to a 44-character value. |
Example
Examples are located in the parameters table with the description of each keyword. By removing the quotation marks, these examples can be used in CLISTs.