Symbolic variables with PeSIT

A symbolic variable represents a transfer data item whose value is not known at the time Transfer CFT parameters are set, but only during the transfer execution. This topic describes how to use symbolic variables within the PeSIT protocol. See Symbolic variables.

At the sender end, the symbolic variables are replaced by the values of the local parameters of the commands.

At the receiver end, the symbolic variables are replaced by the values of the sender parameters, when these values are conveyed by the PeSIT protocol. By default, the local parameter values are substituted for the symbolic variables.

The following table summarizes the replacement of the symbolic variables at the receiver end as a function of the various functional levels negotiated for the PeSIT protocol.

Symbolic variables are replaced at the receiver end according to the functional levels negotiated.

Functional negotiated levels for symbolic variables as they relate to PeSIT

Functional negotiated level

Symbolic variable  

PeSIT plus Transfer CFT extensions 

&PART - Partner name  

&GROUP - Partner group  

&SPART - Sender partner 

&RPART - Receiver partner 

&IPART - Intermediate partner 

&NPART - Partner network name (1) 



&SUSER - Sender user 

&RUSER - Receiver user 

&USERID - Local user identifier 

&COMMENT -     Transfer command

&SAPPL - Sender application 

&RAPPL - Receiver application 

&IDA - Application identifier 

&PARM - Parameter 

&PI99 - PI content


&IDT - Transfer identifier 

&NSUB - Procedure counter 

&DIAGI - Internal diagnostic code 



&DIAGP - Protocol diagnostic code (2) 



&IDF - Model file identifier 

&FNAME - Physical file name 

&FKEYLEN - Key length 

&FKEYPOS - Key position 

&MSG - Message text


&UNIT - Physical file volume 

&UNITC - Volume class 

&NBR - File number of records  

&NBT - File number of transmitted characters


&NBC - File number of read or write characters


&XLATE - Translation table used 

&NIDF - Model file network identifier

&NFNAME - File network name 

&IDM - Message identifier 

&MSG - Message text 

&FUNIT - Sender file name

&FUNITC - Sub-components

&FROOT - Root file name

&FSUF  File name suffix


&FYEAR     Associated date and &FMONTH     time


&FCODE - Receive file code

&NCODE - Network file code



&CYEAR     Catalog entry
&CMONTH     date and time


&BYEAR     Start of transfer
&BMONTH     date and time


&EYEAR     End of transfer
&EMONTH     date and time


 Explanation of table contents:

  • (1): In server mode, &NPART is defined with the identification supplied by the requester at the time the protocol connection is established. In requester mode, &NPART is defined with the value of the NRPART parameter of the local CFTPART command describing the partner.
  • (2): If the transfer is interrupted following an incident notified by the partner, &DIAGP contains the diagnostic of the PeSIT protocol generated by the remote Transfer CFT.
  • R: Defined by the value received, if any 
  • L: Defined by the local value, if any 
  • C: The defined value depends on the utilization context
  • NR: Not defined

Related Links