Testing › Using SYSIDMS Parameters and DCUF SET Statements

Using SYSIDMS Parameters and DCUF SET Statements

Using SYSIDMS parameters you can change the specification of these components of the physical environment in which your program executes without changing the program source:

• Database to be accessed
• Dictionary whose load area contains the subschema
• System to which the program should bind

To take advantage of this feature, the BIND RUN-UNIT statements in the program should not specify the DBNAME, DICTNAME, and NODENAME parameters. Any such hard-coded specification cannot be overridden at execution time.

Batch Execution

For a program executing in batch mode, you can make DBNAME, DICTNAME, and NODENAME specifications in the JCL using SYSIDMS parameters.

For documentation of SYSIDMS parameters, see CA IDMS Common Facilities Guide.

For sample JCL, see the language-specific CA IDMS DML Reference Guide.

Online Execution

For an online program, you can issue a DCUF SET statement to specify database, dictionary, and system. A DCUF SET statement can be submitted to the system by the user or by the program itself.

For more information about DCUF SET statements, see CA IDMS System Tasks and Operator Commands Guide.

User Session Attributes

When a program executes under the central version, the executing user is signed on the system automatically if the user is authorized and an explicit signon has not occurred. Signon processing establishes a set of attributes for the user session, including, for example, DBNAME and DICTNAME and the values assigned to them.

The program can access attribute information with a call to the IDMSIN01 entry point to the IDMS module. The program can use this feature to determine whether the user has the appropriate values assigned to the different components of the execution environment.

For more information about using calls to IDMSIN01, see CA IDMS Callable Services Guide.