Access to Task Attributes in CANDE

For each session, CANDE maintains a task variable and sets selected attributes. CANDE requests some of this information from the user at log-on time and obtains most of the rest from usercode attributes defined in the USERDATAFILE. Tasks initiated within the session inherit the attributes following typical inheritance rules. Attributes that can be set by CANDE include the following:

ACCESSCODE

JOBNUMBER

PRINTDEFAULTS

CHARGE

JOBSUMMARY

PRIORITY

CONVENTION

JOBSUMMARYTITLE

SOURCESTATION

DESTNAME

LANGUAGE

STATION

DISPLAYONLYTOMCS

NOJOBSUMMARYIO

USERCODE

FAMILY

   

Accessing the CLASS attribute of the session or of a task within the session returns the queue number from which CANDE was started.

A task initiated from a CANDE session receives a JOBNUMBER value equal to the session number. The JOBNUMBER value for such a task can range from 100 to 65535, depending on the session number range established by the system command MAX SESSION = <number>.

For a WFL job started from a CANDE session, the MCP assigns a MIXNUMBER value from the mix number pool and assigns a JOBNUMBER value equal to the MIXNUMBER value. The JOBNUMBER value for such a task can range anywhere from 100 to 65535, depending on the mix number range established by the system command MAX MIX = <number>.

You can use CANDE commands to change the values of some of the session attributes. By using these commands, you create new defaults that are applied to all tasks initiated later in that session. The ACCESS, CHARGE, DESTNAME, FAMILY, and LANGUAGE commands each display or assign the session attribute of the same name. Additionally, the PDEF command displays or assigns the PRINTDEFAULTS session attribute.

CANDE supports the following methods of providing default values for the DISPLAYONLYTOMCS task attribute:

  • The session option DISPLAYONLYTOMCS establishes a default DISPLAYONLYTOMCS value for all processes initiated from the current CANDE session. To establish a default of TRUE, use the command ?SO DISPLAYONLYTOMCS. To establish a default of FALSE, use the command ?RO DISPLAYONLYTOMCS.

  • The ?DISPLAYONLYTOMCS control command establishes the initial value of the DISPLAYONLYTOMCS session option for all CANDE sessions. To cause DISPLAYONLYTOMCS to default to TRUE, use the command ?OP + DISPLAYONLYTOMCS. To cause DISPLAYONLYTOMCS to default to FALSE, use the command ?OP- DISPLAYONLYTOMCS.

You can also assign task attributes to specific processes by using task equations. Task equations can be appended to most CANDE process initiation statements, including RUN, UTILITY, COMPILE, and the various special-purpose commands for initiating utilities. Task equations can assign values to all but task-valued or event-valued task attributes, such as EXCEPTIONTASK or EXCEPTIONEVENT. If a task equation conflicts with task attribute inheritance, the task equation takes precedence. For example, the following CANDE command assigns to a process a LANGUAGE value different from the LANGUAGE value of the session:

RUN DRIVER;LANGUAGE = FRANCAIS

For information about the task attributes available in CANDE, refer to the CANDE Operations Reference Manual.