CAS Programming Interface ($CACALL) › Action=LOAD Class=PDOMAIN

Action=LOAD Class=PDOMAIN

Loads panel domains (normally during the initialization of an application). You must perform the LOAD PDOMAIN function before you can use the NAVIGATE PDOMAIN function.

This statement has the following format:

&CONTROL NOSHRVARS
-EXEC $CACALL   OPT=ACTION
                ACTION=LOAD
                CLASS=PDOMAIN
                NAME=‘APPL=application id
                       [TYPE={PUBLIC | PRIVATE}]
                       [USER=userid]
                       [NAME=domain name]’

APPL=application id

A required parameter giving the identifier of the application.

TYPE={PUBLIC | PRIVATE}

An optional parameter giving the type of panel domain. Valid values are as follows:

PUBLIC

Public domain—available for general use.

PRIVATE

Private domain—owned by a specific user ID.

USER=userid

An optional parameter (if TYPE is not PUBLIC) giving the user ID of the user owning the panel domains.

NAME=domain name

An optional parameter giving the name of the panel domain.

Note: The LOAD PDOMAIN function loads all panel domains matching the supplied operands.

Input Variables

This statement has no input variables.

Return Variables

This statement contains the following return variables:

&SYSMSG

System message. Contains the error message (for return code 8).

Feedback Codes

If a return code of 8 is set, then additional information is available as one of the following feedback codes, set in &$CAFDBK:

8

Processing error

10

Nesting level exceeded

Example

The following statements load the panel domains for the application identified by ID ZPR:

&CONTROL NOSHRVARS
-EXEC $CACALL   OPT=ACTION +
                ACTION=LOAD +
                CLASS=PDOMAIN +
                NAME=‘APPL=ZPR’