Determines the next panel to be displayed. You determine the panel by specifying the direction of movement (backward or forward) and the number of panels to skip, or by specifying the name of the panel domain element.
This statement has the following format:
&CONTROL SHRVARS=($PV,pref,...pref)
-EXEC $CACALL OPT=ACTION
ACTION=NAVIGATE
CLASS=PDOMAIN
NAME=‘APPL=application id
[TYPE={PUBLIC | PRIVATE}]
[USER=userid]
NAME=domain name’
[PARMS=‘[CURRENT=element name]
[NEXT={element name | *}]
[SKIP={1 | n}]
[LOAD={YES | NO}]’]
A required parameter giving the application identifier of the panel domain.
An optional parameter giving the type of panel domain. Valid values are as follows:
Public domain—available for general use.
Private domain—owned by a specific user ID.
Note: If you do not specify TYPE or USER, the function attempts to find the panel domain definition owned by the invoking user ID. If unsuccessful, the function uses a public panel domain definition.
An optional parameter (if TYPE=PRIVATE) giving the user ID of the user owning the PRIVATE panel domain. Default is the user ID of the user invoking the function.
A required parameter giving the name of the panel domain.
An optional parameter indicating the current element. If this keyword is blank, the current element are assumed to be ##TOP## (if DIR=FORWARD) or ##END## (if DIR=BACKWARD).
Note: DIR or SKIP is mutually exclusive to NEXT. If you do not specify DIR, NEXT, and SKIP, the default is DIR=FORWARD and SKIP=1.
An optional parameter indicating the direction in which navigation is to occur. The default is FORWARD.
An optional parameter indicating the next element to progress to. If blank, the next element is determined based upon the defined paths (from the current element) and the direction of travel. If an element name is specified, navigation occurs to this element if it is currently eligible. If ’*’ is specified, a pick list of all eligible elements in the domain (excluding the element specified in the CURRENT= keyword) is presented.
An optional parameter indicating the number of times to perform a panel navigation. The default is 1, and the range is 1 through 9999. Use this parameter when the user specifies a numeric or MAX scroll amount.
An optional parameter determining whether to load a domain if it is not currently loaded. The default is YES.
This statement contains variables with prefixes as specified in SHRVARS.
Tracking variables used by CAS to maintain the last nnn elements visited in the current direction (up to 999 elements). These variables are supplied by CAS. Do not modify these variables.
Criteria variables containing the criteria used to specify eligible panel domain element types.
The total number of criteria variables. The range is 0 through 9999.
This statement contains the following return variables:
The name of the next element to progress to.
The name of the panel associated with the next element.
The description of the next element.
The name of the function-level help associated with the next element.
The type (PANEL or TEXT) of the next element.
The title of the next element (if type is TEXT).
System message. Contains the error message (for return code 8).
If a return code of 8 is set, then additional information is available as one of the following feedback codes, set in &$CAFDBK:
Definition not found
Canceled by user
End of sequence
Unable to obtain lock
Processing error
Nesting level exceeded
The following statements identify the next panel for display following the panel in &$PVELEMENT. The panel domain is ZPRPROB in the application identified by ID ZPR. A private panel domain is used in preference to a public panel domain.
&CONTROL SHRVARS=($PV,ZPR) -EXEC $CACALL OPT=ACTION + ACTION=NAVIGATE + CLASS=PDOMAIN + NAME=‘APPL=ZPR + NAME=ZPRPROB’ + PARMS=‘CURRENT=&$PVELEMENT’
| Copyright © 2010 CA. All rights reserved. | Email CA Technologies about this topic |