IMS Version 9

/CHANGE

Format

Read syntax diagramSkip visual syntax diagram/CHANGE Command: APPC Through NODE

>>-+-/CHANGE-+-------------------------------------------------->
   '-/CHA----'

>--+-APPC--+-TIMEOUT--#minutes-+-----------------------------------+-><
   |       '-OUTBND--luname----'                                   |
   |                          .-------.                            |
   |                          V       |                            |
   +-CCTL--cctlname--PRTKN--+---prtkn-+-+--+-ABORT--+--------------+
   |                        '-ALL-------'  '-COMMIT-'              |
   +-CPLOG--cp_log-------------------------------------------------+
   |                   .----------------------------.              |
   |                   V                            |              |
   +-DESC--descriptor----+-LUNAME--luname---------+-+--------------+
   |                     +-MODE--+-modename-+-----+                |
   |                     |       '-NONE-----'     |                |
   |                     +-SIDE--sidename---------+                |
   |                     +-SYNCLEVEL--+-NONE----+-+                |
   |                     |            '-CONFIRM-' |                |
   |                     +-TPNAME--tpname---------+                |
   |                     '-TYPE--+-BASIC--+-------'                |
   |                             '-MAPPED-'                        |
   +-DIR MFS-------------------------------------------------------+
   +-FDR--TIMEOUT--#second-----------------------------------------+
   |         .-------.                                             |
   |         V       |                                             |
   +-LINK--+---link#-+-+--+-+-FORCSESS-+--+----------+-+-----------+
   |       '-ALL-------'  | '-SYNCSESS-'  '-COLDSESS-' |           |
   |                      '-| A |----------------------'           |
   '-NODE--+-nodename----+------------------------+--+-| A |-+---+-'
           |             |         .----------.   |  '-| B |-'   |
           |             |         V          |   |              |
           |             '-USER--+---username-+-+-'              |
           |                     '-ALL----------'                |
           |     .---------------.                               |
           |     V               |                               |
           '---+---+-nodename--+-+-+--+-| A |--------+-----------'
               |   '-nodename*-'   |  '-+----------+-'
               '-ALL---------------'    '-COLDSESS-'

A:

          .-ON--.
|--+-ASR--+-OFF-+-------+---------------------------------------|
   '-MODE--+-modename-+-'
           '-NONE-----'

B:

|--+-FORCSESS-+-------------------------------------------------|
   +-SYNCSESS-+
   '-COLDSESS-'

Read syntax diagramSkip visual syntax diagram/CHANGE Command: OUTBNDThrough USER

>>-+-/CHANGE-+-------------------------------------------------->
   '-/CHA----'

>--+-PASWD--pswdname--+----+--+----------+--pswdname------+----><
   |                  '-TO-'  '-PASSWORD-'                |
   |                             .----------.             |
   |                             V          |             |
   +-SUBSYS--+-subsysname--OASN----oasnname-+-+--RESET----+
   |         | .------------.                 |           |
   |         | V            |                 |           |
   |         +---subsysname-+-----------------+           |
   |         '-ALL----------------------------'           |
   +-SURV--+-LNK-+--+-INTERVAL-+--#seconds----------------+
   |       +-RDS-+  '-TIMEOUT--'                          |
   |       +-LOG-+                                        |
   |       '-ALL-'                                        |
   +-TRAN--tranname--MAXRGN--#regions---------------------+
   |        .-------.                                     |
   |        V       |                                     |
   +-UOR--+---prtkn-+-+--+-ABORT--+-----------------------+
   |      '-ALL-------'  '-COMMIT-'                       |
   '-USER--username----AUTOLOGON----+-------+--+--------+-'
                                    '-| C |-'  +-SAVE---+
                                               '-NOSAVE-'

C:

               .--------------------.
               V                    |
|--nodename------+----------------+-+---------------------------|
                 +-MODE--modename-+
                 +-LOGOND--ldname-+
                 '-ID--idname-----'

Environments and Keywords

Table 21 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 21. Valid Environments for the /CHANGE Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/CHANGE X X X
ABORT X X
APPC X X
ASR X X
AUTOLOGON X X
CCTL X X
COLDSESS X X
COMMIT X X
CPLOG X X X
DESC X X
DIR X X
FDR X X
FORCSESS X X
ID X X
INTERVAL X X
LINK X X
LOGOND X X
LUNAME X X
MAXRGN X X
MODE X X
NODE X X
NOSAVE X X
OASN X X X
OUTBND X X X
PASWD X X X
RESET X X X
SAVE X X
SIDE X X
SUBSYS X X X
SURV X X
SYNCLEVEL X X
SYNCSESS X X
TIMEOUT X X X
TPNAME X X
TRAN X X
TYPE X X
UOR X X
USER X X

Usage

/CHANGE is a multisegment command used to change or delete internal resources within IMS.

All /CHANGE formats require an EOM indication to denote end-of-message; an EOS indication must be included for all segments that precede the last segment. See Multisegment Command Input for more detail on using EOS and EOM.

APPC TIMEOUT
Specifies a change to the timeout value for APPC/IMS. This value is set in the DFSDCxxx member of IMS.PROCLIB. IMS passes this value to APPC/z/OS for every implicit APPC/IMS conversation.

The timeout value (#minutes) must be between zero and 1440. If the timeout value is zero, APPC/IMS timeout will be deactivated.

A DFS34091 or DFS3491I message is issued after the /CHANGE APPC TIMEOUT command is issued to inform the operator of the new timeout value.

OUTBND
Specifies a different outbound LU. The specified LU must be one of the APPC LUs defined in the APPCPMxx member of the SYS1.PROCLIB library. The default outbound LU is BASE LU.
CCTL
Specifies the coordinator control subsystem. The recovery elements are resolved by IMS.
cctlname
Specifies CCTL subsystem ID.
prtkn
Specifies the pseudo recovery token, which designates the unit of recovery to be aborted or committed. Use the /DISPLAY CCTL command to determine the pseudo recovery token name.
ABORT
Backs out changes for a unit of recovery. After completion of backout, the recoverable indoubt structure (RIS) is removed.
COMMIT
Commits changes for a unit of recovery. After the process is complete, the RIS is removed.
CPLOG
Is used to change the value of the IMS execution parameter, CPLOG. The IMS CPLOG execution parameter specifies the number of system log records between system-generated checkpoints.
cp_log
This value must be specified as one or more numeric characters followed by either K or M. Values can range from 1K to 16M.
DESC
Specifies the name of an LU 6.2 descriptor that will be updated with new values. An error message is issued if the specified descriptor is not found.
Note:
The /CHANGE DESC command changes the destination for future messages only. It does not the change the destination for existing messages. The existing output messages are delivered only to the luname and tpname that had been previously specified for that message. This restriction is required by security requirements so message delivery to the intended destination only occurs at the time the messages are created.
LUNAME
Specifies the LU name that is updated in the LU 6.2 descriptor.

The luname value in the descriptor is set to blanks unless the LUNAME keyword is also specified. A network-qualified LU name is optional for the LUNAME keyword.

MODE
Specifies the VTAM mode table entry name that is updated in the LU 6.2 descriptor. The NONE parameter resets the mode field to its null state.

The MODE value in the descriptor is set to blanks unless the MODE keyword is also specified.

SIDE
Specifies the APPC/z/OS side information that is set in the LU 6.2 descriptor. The side information contains default values for APPC conversation attributes such as LUNAME, TPNAME, and MODE.
SYNCLEVEL
Specifies the APPC sync level that is updated in the LU 6.2 descriptor. One of the following must be specified:
CONFIRM
IMS sync point processing continues.
NONE
IMS sync processing continues despite a session failure.
TPNAME
Specifies the tpname that is updated in the LU 6.2 descriptor. Message DFS182 is issued if the TPNAME parameter specified is DFSSIDE.

The TPNAME value in the descriptor is set to blanks unless the TPNAME keyword is also specified.

TYPE
Specifies the APPC conversation type that is updated in the LU 6.2 descriptor.

The conversation types are:

BASIC
Specifies that the data is to be formatted by the transaction programs, using the pattern "LL,data,LL,data".
MAPPED
Specifies that the data is to be formatted by APPC.
DIR
Specifies that the entries in the MFS dynamic directory are to be deleted. This restores the dynamic directory to the original state that it was in just after IMS was initialized.

When IMS is initialized, IMS creates an MFS block primary directory based on the contents of all the $$IMSDIR members found. At the same time, IMS issues GETMAINs to acquire additional storage that is large enough to hold approximately 10% of the members in the active format library. While IMS is running, entries are only added to the dynamic directory, they are not deleted. Therefore, the dynamic directory continues to get larger until it runs out of space. When this happens, IMS can extend the amount of space in the dynamic directory to hold another 10%. IMS can extend the size of the dynamic directory a maximum of 9 times.

If you want to delete the in-storage (or index) entries from the dynamic directory without restarting IMS or performing an online change for the format library, use the /CHANGE DIR MFS command.

FDR
Specifies a change to the timeout value for IMS Fast Database Recovery surveillance. This value is set in the DFSFDRxx member of IMS.PROCLIB. IMS uses this value to determine how long to wait before initiating a Fast Database Recovery takeover.

The timeout value (#seconds) must be at least 3 but no greater than 999.

IMS rejects this command if the active IMS subsystem is not connected to a Fast Database Recovery region.

LINK
Applies only to IMS systems linked by MSC using VTAM.

Use the LINK keyword with FORCSESS, SYNCSESS, COLDSESS to override the system definition option defined for forcing resynchronization until the next /CHANGE LINK command or IMS cold start.

FORCSESS
Forces a session to come up, whether or not the message sequence numbers agree. When FORCSESS is used with COLDSESS, the session is set up so that cold start can occur, and, when it is cold started, it is forced to come up, whether or not the message sequence numbers agree. The use of FORCSESS could cause messages to be lost, so it should be used if a session could not be brought up, and loss of messages is of little importance while a session is being brought up.
SYNCSESS
Is used to complete session initiation, only if the message sequence numbers and the restart modes agree. When this keyword is used with COLDSESS, the session is set up so that it can be cold started, and, after cold start, it can be initiated only if the sequence numbers and the restart modes agree.
COLDSESS
When used in conjunction with the LINK keyword, COLDSESS enables a session to be cold started. If used with FORCSESS or SYNCSESS, the COLDSESS keyword is always processed first. Use of this keyword could cause messages to be lost. This keyword should be used if one of the systems associated with an MSC link goes down, and the only way to bring the session up is to cold start it.

The COLDSESS keyword can be specified to terminate control blocks associated with the specified link or links and reset the link to COLD. COLDSESS should be used only after the /PSTOP command is issued and completes against the link or links and the links appear to be hung. If COLDSESS is specified, it should be used on both sides of the link or links. Gather documentation to determine why the link or links did not come down normally.

ASR
Changes the automatic keyword session restart designation of a link. The default parameter for ASR is ON.

Automatic session restart is not necessarily activated for a link just because a status of ASR is displayed for that link. You must also have coded SONSCIP=YES on the APPL definition statement for VTAM when defining the network for the VTAM.

MODE
Changes the default mode table name of a link. This default is usually established by system definition. Parameter NONE resets this field to its null state (as if no mode table name was specified at system definition).

Changing ASR or mode table name for non-VTAM MSC links is invalid. If non-VTAM MSC links are referred to specifically in the /CHANGE LINK ASR or /CHANGE LINK MODE commands, they will be marked in error.

NODE
Specifies a VTAM node to be changed. The NODE parameter can be generic if the USER keyword is not present. The generic parameter specifies nodes that already exist.
ASR
The ASR keyword allows you to change the automatic session restart designation of a node. The default parameter for ASR is ON.

Automatic session restart is not necessarily activated for a node just because a status of ASR is displayed for that node. You must also have coded SONCSIP=YES on the APPL definition statement for VTAM when defining your network.

COLDSESS
When COLDSESS is used with the NODE keyword, it sets up the SLU P or FINANCE session so that the session can be cold started. The COLDSESS keyword should be used if the SLU P or FINANCE session has experienced problems and attempts to warm start the session fail. The COLDSESS keyword terminates terminal and user control blocks associated with the specified node or nodes, and resets the node status to COLD.

In an IMSplex, if global resource information is not kept in Resource Manager (RM), the change is applied locally. If global resource information is kept in RM, the change is applied globally.

A DFS0581 COMMAND COMPLETE EXCEPT message may be received if the node is temporarily in use by another task even if the criteria (node is terminated and idle) for successful completion of the command is met.

FORCSESS, SYNCSESS
The FORCSESS and SYNCSESS keywords are only valid for ISC nodes. Specify FORCESS and SYNCSESS to override the system definition or logon descriptor option defined to force or not force synchronization of sessions. This override is effective until the next /CHANGE command is issued or an IMS cold start is effected.
MODE
Changes the default mode table name of a node. This default is usually established by system definition or logon descriptor. MODE resets this field to its null state (as if no mode table name had been specified at system definition).

Changing ASR or the mode table name for VTAM 3270 nodes is invalid. If nodes of this type are referred to specifically in the /CHANGE ASR or /CHANGE MODE commands, they are marked in error.

USER
Indicates the ISC user that is allocated to the node or the dynamic user that is signed on to the node.

/CHANGE USER AUTOLOGON SAVE changes the autologon information previously specified by a user descriptor, output creation exit routine (DFSINSX0), or signon exit routine (DFSSGNX0). The autologon change is saved. The autologon information includes the node name, the mode table, the logon descriptor, and the ID. If the Resource Manager is active, the user will be dynamically created if it does not already exist. The SAVE keyword must be specified. If SAVE is not specified, the command is rejected with message DFS1199.

OUTBND
This keyword lets you change the current outbound LU. The default outbound LU is BASE LU. A different outbound LU can be specified with the OUTBND= parameter in the DFSDCxxx PROCLIB member. The specified LU must be one of the APPC LUs defined in the APPCPMxx member of the SYS1.PROCLIB library.
PASWD
Password security is created by the IMS Security Maintenance utility and invoked during IMS restart through the presence of the PASWD operand. PASWD pswdname must be defined prior to the entry of this command. Passwords are defined by use of the Security Maintenance utility or by a previous /CHANGE command. Command execution results in a direct password replacement. If the password operand pswdname does not exist in the user's IMS system, the /CHANGE command is rejected. Because duplicate passwords are not acceptable, PASWD pswdname (where this password name is the second name given in the command) must not have been previously defined when /CHANGE PASWD is entered or the password will be rejected.
SUBSYS
Specifies the subsystem name from which IMS recovery elements are to be deleted. OASN specifies the outstanding recovery element to be deleted. RESET causes an incomplete unit of work assigned to an external subsystem (not a CCTL subsystem) to be deleted.
SURV
Specifies that the interval or timeout value on the active or alternate system in an XRF environment is changed. The following keyword parameters identify the surveillance mechanism:
LNK
IMS ISC link
LOG
IMS system log
RDS
IMS restart data set
ALL
Same as specifying LNK, LOG, and RDS

The INTERVAL or TIMEOUT keyword identifies the new value in seconds and must be in the range 1 through 99. When /CHANGE SURV is entered on the active system, it becomes effective on both the active and alternate systems, if the alternate system is up. If entered on the alternate system, only the alternate system is changed.

It is recommended that surveillance be changed on the active system and allowed to take affect on the alternate system.

Additional considerations when changing the TIMEOUT values are shown in Table 22 Listed in the table are the TIMEOUT value requirements for certain systems where the command is entered on and the action taken for exceptions.

Table 22. Changing the TIMEOUT Value
System the Command is Entered on Requirement Action Taken for Exceptions
Active New timeout value must be >= twice the active interval value. DFS3832 issued. Active timeout value forced to twice the active interval value.
Alternate Alternate interval value must be >= active interval value. DFS3812 issued. Alternate interval value forced to active interval value.
Alternate New timeout value must be >= twice the alternate interval value. DFS3832 issued. Alternate timeout value forced to twice the alternate interval value.

Additional considerations when changing the INTERVAL values are shown in Table 23 Listed in the table are the INTERVAL value requirements for certain systems where the command is entered and the action taken for exceptions.

Table 23. Changing the INTERVAL Value
System the Command is Entered on Requirement Action Taken for Exceptions
Active Twice the new interval value must be <= active timeout value. DFS3832 issued. Active timeout value forced to twice the new interval value.
Alternate Alternate interval value must be >= active interval value. DFS3812 issued. Alternate interval value forced to active interval value.
Alternate New alternate interval value must be >= alternate LOG interval value (LNK and RDS). DFS3833 issued. Alternate interval value forced to alternate log interval value.
Alternate New alternate interval value <= alternate RDS and LNK interval value (LOG only). DFS3833 issued. Alternate interval value forced to alternate RDS then LNK interval value.
Alternate Twice the new interval value must be <= alternate timeout value. DFS3832 issued. Alternate timeout value forced to twice the new interval value.
TRAN, MAXRGN
The MAXRGN keyword is used with the TRAN keyword to change the maximum number of regions that can be simultaneously scheduled for a given transaction. The transaction must be eligible for parallel scheduling (load balancing). For static transactions, the MAXRGN parameter (#regions) is initially set by system definition using the TRANSACT macro statement. For CPI Communications driven transactions, the initial value is obtained from the TP profile. The value of #regions must be between 0 and the number specified on the MAXPST= region parameter.

Related Reading: For more information on the TP profile, see the IMS Version 9: Administration Guide: Transaction Manager. For more information about the MAXPST= parameter, see the IMS Version 9: Installation Volume 2: System Definition and Tailoring.

The /DISPLAY TRAN command indicates whether a transaction is eligible for load balancing with a status of BAL, followed (in parentheses) by the current maximum number of regions that can be simultaneously scheduled.

UOR
Specifies that IMS should resolve units of recovery (UORs) for protected resources on the RRS/z/OS recovery platform.

Recommendation:  Use /CHANGE UOR only when you are certain that no other resource managers would be adversely affected after IMS resolves the UOR.

prtkn
Specifies the six-byte pseudotoken that designates the UOW to be committed. Use the /DISPLAY UOR command to obtain the prtkn.

If you specify ALL, the /CHANGE UOR command affects all units of recovery.

ABORT
Specifies that IMS back out changes for the protected resources.
COMMIT
Specifies that IMS make changes permanent for the protected resources.
USER
Specifies that an ETO will change. The user parameter cannot be generic.
AUTOLOGON
Specifies that the autologon information previously specified by a user descriptor, the output creation exit routine (DFSINSX0), or the signon exit routine (DFSSGNX0) is being updated dynamically.
nodename
Specifies the autologon terminal session for the specified user. Omitting the nodename clears all autologon information.
MODE
Specifies the VTAM mode table entry name.
LOGOND
Specifies the logon descriptor used to build the terminal control blocks.
ID
Specifies the ISC partner's half-session qualifier (if the terminal is ISC).
NOSAVE
Indicates that the changed autologon information should not be retained. Deletion of the user occurs when an IMS checkpoint is taken, at session termination, IMS restart, or XRF takeover. If SAVE and NOSAVE are omitted, IMS uses the system-wide default as specified in the DFSDCxxx PROCLIB member.
SAVE
Indicates that the changed autologon information should be retained. This keyword prevents deletion of the user and remains in effect across a restart or XRF takeover until another /CHANGE command with the NOSAVE option is issued. If SAVE and NOSAVE are omitted, IMS uses the system-wide default as specified in the DFSDCxxx PROCLIB member.

If global resource information is kept in Resource Manager, the change is applied globally when the SAVE keyword is specified. If SAVE is not specified in this environment, the command is rejected.

Examples

Example 1 for /CHANGE Command

This set of examples shows that an INDOUBT unit of recovery can be aborted if the INDOUBT status cannot be resolved. The /CHANGE ... PRTKN command backs out changes made to the database.

Entry ET:

  /DISPLAY CCTL CICS1 IND

Response ET:

    CCTL     PSEUDO-RTKN RECOVERY-TOKEN   REGID  PSBNAME   STATUS
    CICS1                                                  ATTACHED
             000100C0    9FFA956B7AE24E00        BMP255    INDOUBT
             00010040    9FFA9568FF594301        BMP255    INDOUBT
     *90067/113446*

Entry ET:

/CHANGE CCTL CICS1 PRTKN 000100C0 ABORT (EOM)

Response ET:

DFS058I  CHANGE COMMAND COMPLETED
DBS0699I REYNC ABORT COMPLETE FOR PSB BMP255...

Explanation: The INDOUBT unit of recovery whose pseudo recovery token (PRTKN) is 000100C0 has been aborted.

Example 2 for /CHANGE Command

This set of commands illustrate how the ASR setting of a link can be modified by the /CHANGE command:

Entry ET:

  /DISPLAY LINK 6

Response ET:

  LINK PARTNER   RECD  ENQCT  DEQCT   QCT   SENT
     6 AL          0      0      0     0      0 ASR PSTOPPED IDLE COLD
  *90179/102004*   IMSA

Explanation: Automatic Session Restart was defined for link 6 by system definition.

Entry ET:

  /CHANGE LINK 6 ASR OFF (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Entry ET:

  /DISPLAY LINK 6

Response ET:

  LINK PARTNER   RECD  ENQCT  DEQCT    QCT    SENT
     6 AL          0      0      0      0       0 PSTOPPED IDLE COLD
  *90179/102126*

Explanation: Automatic Session Restart is not available for link 6

Entry ET:

  /CHANGE LINK 6 ASR (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Explanation: The ASR parameter will default to ON.

Entry ET:

  /DISPLAY LINK 6

Response ET:

  LINK PARTNER   RECD  ENQCT  DEQCT    QCT    SENT
     6 AL          0      0      0      0       0 ASR PSTOPPED IDLE COLD
  *90179/102300*

Explanation: Automatic Session Restart is in effect again as a result of the second /CHANGE command.

Example 3 for /CHANGE Command

Changing ASR for NODE or NODE/USER is similar to changing ASR for LINK. See the previous example for the commands used to change ASR.

Example 4 for /CHANGE Command

Entry ET:

  /DISPLAY NODE LUTYPEP1 MODE

Response ET:

  NODE-USR   TYPE   DEF MODETBL  ACT MODETBL
   LUTYPEP1  SLUP   DEFRESP
   *90179/100630*

Explanation: DEFRESP is the mode table name defined for node LUTYPEP1 at system definition or logon descriptor or resource creation. The session is not active so the active mode table field (ACT MODETBL) is blank.

Entry ET:

  /CHANGE NODE LUTYPEP1 MODE XXXXXXXX (EOM)

Response ET:

  DFS058I CHANGE COMMAND COMPLETED

Entry ET:

  /DISPLAY NODE LUTYPEP1 MODE

Response ET:

  NODE-USR TYPE   DEF MODETBL  ACT  MODETBL
  LUTYPEP1 SLUP   XXXXXXXX
  *84179/100733*

Explanation: The default mode table name has been changed to XXXXXXXX by the previous /CHANGE command. The session is still not active so the active mode table field (ACT MODETBL) is blank.

Example 5 for /CHANGE Command

Entry ET:

/DISPLAY NODE LUTYPEP

Response ET:

NODE-USR  TYPE   CID      RECD  ENQCT  DEQCT  QCT  SENT
LUTYPEP   SLUP  00000000    37     37     37    0    37  IDLE
*98276/153630*

Explanation: Node LUTYPEP is terminated warm after session received and processed 37 messages.

Entry ET:

/CHANGE NODE LUTYPEP COLDSESS (EOM)

Response ET:

DFS058I CHANGE COMMAND COMPLETED

Entry ET:

/DISPLAY NODE LUTYPEP

Response ET:

NODE-USR  TYPE   CID      RECD  ENQCT  DEQCT  QCT  SENT
LUTYPEP   SLUP  00000000     0      0      0    0     0  IDLE COLD
*98279/153630*

Explanation: Terminal and user blocks associated with node LUTYPEP have been cleared and the status has been reset to COLD.

Example 6 for /CHANGE Command

Entry ET:

  /CHANGE PASSWORD 1234 TO WXYZ (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Explanation: Password 1234 is changed to password WXYZ.

Example 7 for /CHANGE Command

Entry ET:

  /CHANGE SUBSYS DSN RESET (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Explanation: Reset all IN-DOUBT recovery units for subsystem DSN.

Example 8 for /CHANGE Command

Entry ET:

  /CHANGE SUBSYS ALL RESET (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Explanation: Reset all IN-DOUBT recovery units for all subsystems.

Example 9 for /CHANGE Command

Entry ET:

  /CHANGE SUBSYS ABCD OASN 99 685 2920 RESET (EOM)

Response ET:

  DFS058I  CHANGE COMMAND COMPLETED

Explanation: Reset IN-DOUBT recovery units identified by OASN numbers 99, 685, 2920 for subsystem ABCD.

Example 10 for /CHANGE Command

This set of commands illustrates how SURVEILLANCE can be modified by the /CHANGE command.

Entry ET (Alternate system):

  /DISPLAY HSB

Response ET (Alternate system):

  RSENAME       STATUS    PHASE    IMS-ID    VTAM UVAR  ACT-ID    LOG-TIME
  DFSRSENM      BACKUP    TRK      IMSB      USERVAR    IMSA      10:35:17
                BACKUP SYSTEM                 ACTIVE SYSTEM
  SURVEILLANCE  INTERVAL  TIMEOUT  STATUS     INTERVAL  TIMEOUT  STATUS
  LOG                  2       99  INACTIVE          2       99  INACTIVE
  LNK                  4       99  INACTIVE          4       99  INACTIVE
  RDS                  3       99  INACTIVE          3       99  INACTIVE
  TAKEOVER CONDITIONS - ALARM AUTO
  RDS LINK LOG                  *RDS LINK
  VTAM                          *IRLM
  *91226/103517*

Entry ET (Alternate system):

  /CHANGE SURVEILLANCE LNK INTERVAL 3 (EOM)

Response ET (Alternate system):

  DFS058I CHANGE COMMAND COMPLETED
  DFS3812I BACKUP LNK INTERVAL VALUE OF 3 HAS BEEN FORCED TO ACTIVE VALUE OF 4
  DFS3811I LNK SURVEILLANCE INACTIVE: INTERVAL VALUE CHANGED FROM  4 TO  4

Explanation: An attempt to change the interval value was made by entering /CHANGE on the alternate system. The new alternate interval value was not >= the active interval value so IMS forced the interval to the active value and issued asynchronous message DFS3812. Asynchronous message DFS3811 indicates the status of the change following the above action by IMS.

Example 11 for /CHANGE Command

The following commands illustrate how to change the maximum number of regions that can be simultaneously scheduled for a given transaction.

Entry ET:

  /DISPLAY TRANSACTION SKS7

Response ET:

    TRAN   CLS ENQCT   QCT   LCT  PLCT CP NP LP SEGSZ SEGNO PARLM RC
  SKS7       7     0     0 65535 65535  8  8  8     0     0     1  0
      PSBNAME: DFSDDLT7
      STATUS: BAL(  2)
  *90226/134816*

Explanation: The status of transaction SKS7 indicates it is eligible for load balancing (BAL) and that two regions can be simultaneously scheduled.

Entry ET:

  /CHANGE TRANSACTION SKS7 MAXRGN 4 (EOM)

Response ET:

  DFS058I CHANGE COMMAND COMPLETED

Entry ET:

  /DISPLAY TRANSACTION SKS7

Response ET:

    TRAN   CLS ENQCT   QCT   LCT  PLCT CP NP LP SEGSZ SEGNO PARLM RC
  SKS7       7     0     0 65535 65535  8  8  8     0     0     1  0
      PSBNAME: DFSDDLT7
      STATUS: BAL(  4)
  *90226/134845*

Explanation: The maximum number of regions that can be simultaneously scheduled for transaction SKS7 has been changed from 2 to 4.

Example 12 for /CHANGE Command

The following commands illustrate the changing of a unit of recovery.

Entry ET:

  /CHANGE UOR 010040 ABORT

Response ET:

  DFS058I CHANGE COMMAND COMPLETED
  DFS0699I RESYNC ABORT  COMPLETE FOR PSB STLDDTL1, PRTKN=00010040,
         TOKEN IMS2    0000000100000000 IMS2
    *97226/134816*

Explanation: IMS backs out changes for pseudo recovery token 010040.

Entry ET:

  /CHANGE UOR 010040 COMMIT

Response ET:

  DFS058I CHANGE COMMAND COMPLETED
  DFS0699I RESYNC COMMIT COMPLETE FOR PSB STLDDTL1, PRTKN=00010040,
         TOKEN IMS2    0000000100000000 IMS2
    *97226/134816*

Explanation: IMS makes changes for pseudo recovery token 010040 permanent.

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