You can control DFSMSdss through PARM Information in the EXEC Statement by using the Cross Memory Application Interface. The EXEC statement for DFSMSdss, when invoking DFSMSdss with the Cross Memory Application Interface, can contain PARM information that is used by the client and server, as well as the ADRDSSU program itself. The same values that can be specified in the EXEC PARM field in the JCL for ADRDSSU can also be specified in the EXEC PARM field for ADRXMAIA.

SRVRTIME=([minutes]{:seconds})

The SRVRTIME parameter specifies the amount of time the server address space should wait to shut down after the last piece of work has finished. If the Cross Memory Application Interface is invoked again, specifying this particular server before the specified time has passed, this server will take the piece of work. When the time expires and no more pieces of work have been submitted, the server will shut down, and a subsequent invocation of the Cross Memory Application Interface specifying this server name will cause a new server to be created. The first invocation of the Cross Memory Application Interface for a particular server determines the length of time while that particular server is running. Subsequent invocations to the same server while it is running will not change the time even if the SRVRTIME parm is specified on those later invocations.

minutes

Specifies the maximum number of minutes the server will wait after the last piece of work is finished before shutting down. The minutes must be a number from 0 through 357912 (248.55 days).

seconds

Specifies the maximum number of seconds the server will wait after the last piece of work is finished before shutting down. The seconds must be a number from 0 through 59.

The following examples demonstrate the affect on the system when you designate a SRVRTIME value:

• SRVRTIME=(1:30) - The server will wait for 1 minute 30 seconds before shutting down.
• SRVRTIME=(24:00) - The server will wait for 24 minutes before shutting down.
• SRVRTIME=(0:25) or SRVRTIME=(:25) - The server will wait for 25 seconds before shutting down.
• SRVRTIME=(0:00) - The server will shut down immediately after the last piece of work is finished.

Restrictions: If the SRVRTIME parameter is not specified, the time before the server shuts down is determined as follows:

• If the Cross Memory Application Interface is invoked from JCL, but the ASPACE parameter is not specified, the server will shut down after 4 minutes.
• If the Cross Memory Application Interface is invoked with JCL and the ASPACE parameter is specified, the server will wait 1 minute.
• If the Cross Memory Application Interface is invoked using the LINK, CALL, or ATTACH macros, but an ASPACE name wasn't provided in the ASIDPTR field, the server will wait 8 minutes.
• If the Cross Memory Application Interface is invoked using the LINK, CALL, or ATTACH macros and an ASPACE name was provided in the ASIDPTR field, the server will wait 1 minute.

ASPACE=id

Where id is determined by the installation to identify which server to use for processing DFSMSdss SYSIN command streams. ASPACE=AFFINITY is a special use. It causes ADRDSSU to be used within the client address space instead of running in a separate address space.

NOTE: ASPACE is only available when using JCL to invoke DFSMSdss with the cross memory application interface.

The following example demonstrates how you might designate the use of the ASPACE parameter:

 //S1 EXEC PGM=ADRXMAIA,PARM='ASPACE=BACKUP'

SNAPX=*|nn|(nn,nn[,nn])

The SNAPX parameter can be used to debug your user interaction module. The SNAPX parameter can be specified on JCL and system invocations of the Cross Memory Application Interface (API). Specifying the SNAPX parameter requests that ADRXMAIA write the contents of the EIDB and EIRECPTR to SYSPRINT whenever the specified exit is called. When an application writes its own messages to SYSPRINT, ADRXMAIA calls exit 2 of the user interaction module for that application.

When specifying the SNAPX parameter, you can specify:

• One exit to snap. For example, you can specify SNAPX=12 to see the contents of exit 12.
• More than one exit to snap. For example, you can specify SNAPX=(1,6,2) to see the contents of exits 1,2, and 6.
• All command processing exits. For example, you can specify SNAPX=*.

The following example demonstrates how you might designate the use of the SNAPX parameter:

 //S1 EXEC PGM=ADRXMAIA,PARM='SNAPX=(21,22,23)'