Xchange IMS Transaction IDs

Xchange can be initiated with either of two separate IMS transactions:

• To invoke standard Xchange IMS Message Level Support, type XGTM, plus the usual trailing space, on a blank IMS screen and press Enter.
• To invoke Xchange as an administrative user, type XGTS, plus the usual trailing space, on a blank IMS screen and press Enter.

Administrative users can view and delete Xchange requests for all users or LTERMs in the IMS region. An administrative user can also completely inactivate all Xchange requests by entering the INACTIVATE primary command and activate them by entering the ACTIVATE primary command. Access to the XGTS transaction can be restricted to selected users with your site's existing security package.

IMS Simulated Date Time Settings Screen

Specifying Requests

The IMS Simulated Date Time Settings screen lets you specify requests for simulated system date and time scenarios for your IMS applications.

Each line is an entry where you can type information defining which portions of your IMS application or applications are to be tested using Xchange. Each individual entry that you create is called a request. All the entries together constitute the request table, which is stored in the Xchange request file. When you press Enter, any line commands you put in the C field are executed for each corresponding request.

The remainder of this section discusses five aspects of using the IMS Simulated Date Time Settings screen:

• primary commands
• line commands
• status codes
• fields
• PF keys

Primary Commands

Under Xchange IMS Message Level Support, an administrative user can enter the ACTIVATE, INACTIVATE, and PREFIX primary commands, and all other users can enter the ADVANCE, OFFSET, PRIMARY, and RELEASE primary commands.

Type primary commands in the Command field at the top of the Xchange screen.

Primary Commands for Administrative User

The following primary commands are available to the administrative user on the IMS Simulated Date Time Settings screen:

ACTIVATE

The ACTIVATE command globally enables Xchange date/time simulation for every active request. Using the ACTIVATE command does not change the activation status of individual requests as displayed in the A field.

INACTIVATE

The INACTIVATE command globally disables Xchange date/time simulation for every active request. Using the INACTIVATE command does not change the activation status of individual requests as displayed in the A field.

PREFIX

The PREFIX command allows an administrative user — one who invoked Xchange IMS Message Level Support with the XGTS transaction — to view the requests associated with other user IDs or logical terminals (LTERMs). Type PREFIX userID in the COMMAND field and press Enter to display all Xchange requests for the specified user ID. An asterisk (*) can be used as a wildcard character. Enter PREFIX * to view all requests in the Xchange request file. Enter *PREFIX abc* , where abc is a partial user ID or LTERM, to view all the requests of users or terminals that start with that string. Enter PREFIX ? to display the current prefix status.

Primary Commands for All Users

The following primary commands are available to all users on the IMS Simulated Date Time Settings screen:

ADVANCE

Use the ADVANCE command to display the Advance Request Settings screen for IMS message level support. For more information, see Advancing-Xchange-Requests-Using-IMS-Message-Level-Support.

OFFSET

Use the OFFSET command to display the IMS Simulated Date Time Settings screen in offset format. This command is available to all users. For more information, see Using-IMS-Message-Level-Support-with-Date-Time-Offset.

PRIMARY

Display the list of valid primary commands.

RELEASE

The RELEASE command displays the release number of Xchange IMS Message Level Support you are using. If you type RELEASE in the COMMAND field and press Enter, Xchange will display the release number at the bottom of the IMS Simulated Date Time Settings screen.

Line Commands

A line command must be entered to create, modify, or delete an Xchange request. Type line commands in the C field (see Fields) and press Enter to execute them. The following line commands are available on the IMS Simulated Date Time Settings screen:

The following line command is available on the IMS Advance Request Settings screen:

Status Codes-Xchange IMS Transaction IDs

Status codes are displayed in the S field next to each Xchange request (see Fields). Any of the following status codes can be displayed:

Fields

Command

The field for entry of Xchange primary commands. For a listing and description of primary commands, see Primary-Commands.

Xchange Subsystem ID

Displays the MVS ID of the Xchange subsystem and indicates whether the subsystem is up.

Active

Displays YES or NO to indicate whether active Xchange requests are enabled for date/time simulation. YES is displayed after an ACTIVATE command is entered, and NO is displayed after an INACTIVATE command is entered.

C

The field for entry of line commands for each Xchange request. For a listing and description of valid line commands, see Line-Commands.

A

Displays the activation status of each Xchange request. The letter Y (yes) indicates that the request is active and, if YES is displayed in the ACTIVE field, date/time simulation will occur when the specified program or job is executed. The letter N (no) indicates that the request is inactive. The activated status of all requests can be globally overridden by an administrative user with the INACTIVATE command.

S

Displays the status of each Xchange request. The letters H, P, or J indicate the request type based on the line command that was used to create it. An asterisk (*) indicates that the request contains an error.

Owner

Displays the user ID of the person who created the request, if logged onto IMS by user ID, or the LTERM on which the request was created. A user who accessed Xchange with the XGTM transaction can only view requests for which they are the owner. An administrative user can enter the PREFIX primary command to view the requests of any or all Xchange users. See Primary Commands for Administrative User.

Req ID

Displays the user ID, LTERM, or jobname that identifies the request. This field is also used to enter the jobname of requests set with the J line command. For requests set with the H or P line commands, this field defaults to the current user ID or LTERM. An administrative user can also enter the user ID or LTERM of any Xchange user.

Program

The field for entering the name of the program for which date/time simulation is to be performed. In requests created with the H or P line commands, an asterisk wildcard character can be used to specify multiple programs. For example, entering ABC* in the Program field will create a request for all programs whose names begin with ABC that are run under the user ID or LTERM in the Req ID field. If no program name — or a single asterisk — is entered in the Program field, the request will affect every program of the user ID or LTERM in the Req ID field. For requests created with the J line command, only an administrative user can include an asterisk in the Program field.

YYYY/MM/DD

The year, month, and day that you want Xchange to simulate. The same fields are provided under two headings, IOPCB and MVS/HLL. The date values under the IOPCB heading are substituted for the IOPCB values of the specified program or job. Those under the MVS/HLL heading are used to exchange other MVS and high-level language TIME services calls. The MVS/HLL fields default to the corresponding values entered in the IOPCB fields, as indicated by the equal sign (=) in the first position of the YYYY column. The following entries are valid:

If you enter a value for the day (DD), the month and year are required. If you enter a value for the month (MM), the year is required. You can enter just the year. This field defaults to the current year, month, and day.

HH:MM:SS

The hour, minute, and second that you want Xchange to simulate for the specified date. The same fields are provided under two headings, IOPCB and MVS/HLL. The time values under the IOPCB heading are substituted for the IOPCB values of the specified program or job. Those under the MVS/HLL heading are used to exchange other MVS and high-level language TIME services calls. The MVS/HLL fields default to the corresponding values entered in the IOPCB fields, as indicated by the equal sign (=) in the first position of the YYYY column. The following entries are valid:

If you enter a value for seconds (SS), the hour and minutes are required. If you enter a value for minutes (MM), the hour is required. You can enter just the hour in this field. If only hours or hours and minutes values are entered, the remaining fields will default to the time at which the request is created. If no values are entered, this field displays all zeros and defaults to the running current hour, minute, and second at the time of task execution.

Message area

The line follownig the request entry fields is used to display Xchange and IMS messages.

PF Keys

IMS Message Level Support recognizes the following function keys which are also displayed at the bottom of the IMS Simulated Date Time Settings screen:

• PF1 (Help)
• PF2 (Copyright/Trade Secret Notice)
• PF7 (Scroll Up)
• PF8 (Scroll Down)
• Clear (Exit Xchange).

Comparison of Request Types

The following table presents a comparison of the three different types of IMS Message Level Support Xchange requests set with the P, H, and J line commands. The table summarizes the values displayed or entered in each request field and notes any differences associated with use of the administrative user XGTS transaction.

IMS Request Types