Interface Environmental Commands

When SET IMS=NEW, you have access to Interface environmental commands with which you can change certain parameters that control your FOCUS session.

To distinguish them from FOCUS commands such as the SET IMS command, Interface environmental commands include an MVS or TSO environmental qualifier and the keyword IMS.

The syntax is

{MVS|TSO} IMS SET env_command value

where:

env_command

value

Is an acceptable value for the environmental command.

Although the commands are prefixed with the environmental qualifier TSO or MVS, the Interface, and not the operating system, handles them.

Note: The MVS and TSO environmental qualifiers are synonymous and can be used interchangeably in any MVS environment (for example, TSO, batch, or MSO).

Commands for Implementing the DBCTL Environment

From a TSO session or batch job, you invoke the DBCTL environment (available with IMS 3.1 and up, see Environments) by issuing the following two commands in the order shown

{MVS|TSO} IMS SET IMSPZP {xx|00}

{MVS|TSO} IMS SET DBCTL {ON|OFF}

where:

xx

Sets the two-character suffix for the DRA Startup Table, chosen during installation (see Installation Instructions Instructions). If you do not issue this command, the suffix defaults to 00.

ON

Turns on the DBCTL environment.

OFF

Turns off the DBCTL environment. OFF is the default in a TSO session.

Note: If you are running MSO:

• These settings are included in the MSO configuration file; see Installation Instructions.
• DBCTL ON is the default as long as DBCTL is available, indicated by the attribute DBCTL=START in the configuration file. You can then control the DBCTL setting using console commands, as described in Installation Instructions.

If you did not create an Access File to automatically select the PSB for your request (see Chapter 3, Creating FOCUS Descriptions) or to change the selected PSB, issue the following command

{MVS|TSO} IMS SET PSB psbname

where:

psbname

Is the name of the FOCPSB library member to use. This name must be identical to the name of the actual PSB that IMS will access. If the member does not exist, the following error message is generated:

	(FOC4261) FOCPSB MEMBER NOT FOUND: psbname

Note:

• All participating files in a join must use the same PSB. Any attempt to join files that require different PSBs generates the following error message:

(FOC4295) ACCESS POINTS TO DIFFERENT PSBS IN JOIN

• The IMS SET PSB command supersedes the PSB attribute in the Access File.

The IMS SET ? Query Command

If SET IMS=NEW, the default, you can issue the IMS SET ? command at any time during your session to display Interface defaults and current settings.

The syntax is:

{MVS|TSO} IMS SET ?

For example:

 >  > TSO IMS SET DBCTL ON
 >  > TSO IMS SET IMSPZP 05
 >  > TSO IMS SET PSB TSTPSB01
 >  > TSO IMS SET ?
 (FOC4280) IMSMODE   : DBCTL
 (FOC4281) PSB       : TSTPSB01
 (FOC4282) IMSSEC    : OFF
 (FOC4283) IMSCLASS  :
 (FOC4284) IMSPZP    : 05

Note:

• IMSSEC and IMSCLASS are security settings available through MSO (see Security).
• IMSMODE values are:

Value	Mode
DBCTL	DBCTL
REMOTE	BMP
LOCAL	DLI

For more information on modes, see Environments.

• If you issue the IMS SET ? query command with SET IMS=OLD in effect, no settings are displayed, and you are returned to the FOCUS prompt. Therefore, you can determine which IMS setting (OLD or NEW) is in effect by whether the IMS SET ? query command produces a display of current settings.