Adapter Environmental Commands

When SET IMS=NEW, you have access to adapter 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, adapter environmental commands include an MVS or TSO environmental qualifier and the keyword IMS.

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

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

Commands for Implementing the DBCTL Environment

From a TSO session or batch job, you invoke the DBCTL environment 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.

If you did not create an Access File to automatically select the PSB for your request (see 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
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.

Value	Mode
DBCTL	DBCTL
REMOTE	BMP
LOCAL	DLI