Variables for follow-up processing

The following table shows which variables can be used for which system.

Variable	Meaning	BS2000	Unix system	Windows	z/OS
%PARTNER	Partner name (long form)	X	X	X	X
%PARTNERAT	Partner name (short form)	X	X	X	X
%FILENAME	File name	X	X	X	X
%ELEMNAME	Element name	X
%ELEMVERS	Element version	X
%ELEMTYP	Element type	X
%RESULT	Request result	X	X	X	X
%JOBCLASS	Job class	X

In the case of %PARTNER and %PARTNERAT, the partner name found in the partner list is used if it is present in the partner list. If it is not entered in the partner list (dynamic partner) then the partner address is used. In this case, %PARTNER and %PARTNERAT have different effects:

• In the case of %PARTNER, all the address components are used, i.e. including protocol prefix, port number and selectors if appropriate.

• In the case of %PARTNERAT, only the host address component is used, see section“Specifying partner addresses”. In addition, all characters apart from letters, digits or periods are replaced by ’@’.

If one of the above-named symbolic identifiers remains in this form, that is without replacement, then the initial percentage sign must be doubled, as in %%FILENAME.

Additional variables on z/OS

The following variables can be used:

%FILN	Like %FILENAME.
%FILX	Like FILN, except that quotes are automatically doubled during the replacement.
%PNAM %USID	Symbolic name of the partner system. A maximum of 8 characters. User ID from the PROCESSING-ADMISSION for the relevant system, if specified, otherwise from the TRANSFER-ADMISSION. A maximum of 7 characters in accordance with IBM conventions.
%ACCN	Accounting information from the PROCESSING-ADMISSION for the relevant system, if specified, otherwise from the TRANSFER-ADMISSION. A maximum of 40 characters in accordance with IBM conventions.
%ACCX	Like ACCN, except that quotes are automatically doubled during the replacement.
%PASS	Password from the PROCESSING-ADMISSION for the relevant system, if specified, otherwise from the TRANSFER-ADMISSION. A maximum of 8 characters in accordance with IBM conventions.
%OWID	Owner of the FT job, i.e. the user ID under which the transfer job was created. A maximum of 7 characters in accordance with IBM conventions. This parameter is replaced only in the system in which the transfer job was created. It is eliminated in the partner system. It should therefore be specified only in follow-up processing for the local system.
%PGRN	Programmer's name, as specified with the keyword PGRN= as a subcommand in the command string for follow-up processing in the relevant system (see section Specifying a programmer's name). A maximum of 20 characters in accordance with IBM conventions.
%PGRX	Like PGRN, except that quotes are automatically doubled during the replacement.
%TRID	FT job identifier in the relevant system. A maximum of 10 characters (value range 1..2147483639) in accordance with openFT conventions.

For reasons of compatibility with previous versions, the character "&" should be used to make sure that previous versions also handle the variables correctly.

The names of these variables should have as many trailing "#" fill characters as are necessary for a field to be set to its maximum length (including the "&" character, e.g. &TRID#####). When replacing the variables by the current values, openFT does not exceed the field length predefined by the name of the symbolic parameter including the trailing "#" fill characters; if necessary the current values are truncated. On the other hand, where the current values are shorter than this field length, openFT removes superfluous blanks.

For the FILX, ACCX and PGRX parameters, in which quotes are automatically doubled during the replacement, the number of trailing characters must be increased by the number of quotes possibly contained in the current value (i.e. 2 additional trailing characters for FILX and ACCX, whose current value can be enclosed in quotes, but which cannot themselves contain quotes, and at least 3 additional trailing characters for PGRX for the external quotes and at least one quote contained in the name).