.NRET key

On enabled panels, the .NRET key retrieves the library names from the current library referral list or data set, or workstation file name from the current data set referral list. Unlike some othe dot variables, .NRET can be assigned multiple times in panel logic.


>>-.NRET--=--+-ON--+-------------------------------------------><
             +-OFF-+   
             +-DSN-+   
             '-LIB-'

where:

ON: Sets the NRETRIEV command table entry active.
OFF: Sets the NRETRIEV command table entry inactive.
DSN: Tells ISPF that the NRETRIEV command retrieved a name from the current data set referral list.
LIB: Tells ISPF that the NRETRIEV command retrieved a name from the current library referral list.

Other values are reserved by ISPF. No messages are given in case of an assignment that is not valid.

When .NRET is used as the source for an assignment statement it always returns a null.

The user is responsible for assigning NRETRIEV to a PF key. NRETRIEV is normally inactive but can be made active by using the .NRET=ON assignment in the )INIT and )REINIT section of a panel. If it is turned on, .NRET=OFF must be executed in the )PROC section of the panel. Failure to turn off .NRET in the )PROC section of the panel can lead to errors when the NRETRIEV key is pressed on subsequent panels.

NRETRIEV sets these variables in the FUNCTION pool:

Variable: Function
ZNRPROJ: Project name
ZNRGRP1: First group name
ZNRGRP2: Second group name
ZNRGRP3: Third group name
ZNRGRP4: Fourth group name
ZNRTYPE: Type name
ZNRMEM: Member name
ZNRODSN: Other data set name
ZNRVOL: Volume associated with the other data set name
ZNRLIB: Successful library retrieve (YES or NO)
ZNRDS: Successful data set retrieve (YES or NO)
ZNRWSN: Workstation name indicator for other data set name
: (H = Host, W = Workstation)