Invoking the Menu System

Customization › Menu System and Web Interface › Invoking the Menu System

Invoking the Menu System

When the CA Spool menu system is invoked from another CICS program, it supports transfer of information to the menu system. This means that any menu screen is activated directly from the other transaction, including setting of owner prefix, printer prefix, and so on.

Note: The invocation must be done using XCTL to the menu system program with a common area as specified in the following table:

Offset (decimal)	Length	Description
000	008	Reserved. Must be initialized to X'00'.
008	004	Restart transaction code. Must name a CICS transaction to invoke the menu system. It is used to regain control after giving control to CICS waiting for the user to enter new information.
012	004	New transaction code. If this field is non-blank, the value specified is used as "next-transaction-ID" when the menu system terminates.
016	008	Program name. If this field is non-blank and the new transaction code is blank, the CA Spool menu system will XCTL to this program when it terminates.
024	002	Command. If this field is non-blank it is used as a command for the CA Spool menu system, such as F/FA/P/PS/PB.
026	008	Related node. In this field is non-blank it is used as a related node equivalent to specifying RN xxxxxxxx. It must be 8-characters long, padded with spaces.
034	006	Related group. If this field is non-blank it must be numeric with leading zeros. The value indicates the related group equivalent to specifying RG 999.
040	008	Owner prefix. If this field is non-blank it is used as the owner prefix equivalent to specifying OP xxxxxxxx. The field must be 8-characters long and padded with spaces.
048	008	Printer prefix. If this field is non-blank it is used as the printer prefix equivalent to specifying PP xxxxxxxx. The field must be 8-characters long and padded with spaces.
056	004	Subsystem name. If this field is non-blank it is used as the subsystem name equivalent to specifying SUB xxxx. The field must be 4-characters long and padded with spaces.
060	008	NJE name. If this field is non-blank it is used as the NJE name equivalent to specifying NJE xxxxxxxx. The field must be 8-characters long and padded with spaces.
068	002	Length of user field. This field must be a binary half word indicating the length of the following field.
070	—	User field. If the previous field specifies a length greater than zero, this field is passed as COMMAREA to the new transaction or new program, which gains control when the CA Spool menu system terminates.