Sentinel to Transfer CFT to InterPEL mapping

The following tables list parameter correspondence between Transfer CFT, Sentinel, and InterPEL. You find this mapping using in migrating from InterPEL to Transfer CFT.

Note The fields prefixed with "MLH" are fields that are specific to the PeSIT Hors SIT protocol, which are contained in the recording transfer from the Mailbox and are accessible by the Assembly Exits.

XFBTransfer tracked object

Roles

Sentinel

attribute

Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Direction Integer -

S: The file is sent (Sender).

R: The file is received (Receiver).

DIRECT

From direction:

"R" "E" "B"

TYPEREQ={S|M or C}
IsServer Integer -

1: The Sender or the Receiver is a Server.

0: The Sender the Receiver is a Requester.

FLAG

From mode:

Initiator "R" Responder "S"

MLHMODR - Initiator “R” Responder “S” (depending on the STOSR parameter)

Senders and receivers

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Site String 25 Partner alias of the remote partner. PART remote_agent DEST
ReceiverId String 80 Name of the Receiver. NRPART

from:

local_agent_ident (direct IN)

remote_agent_ident (direct OUT)

MLHDEM (from LOCAL or SITLNAM parameters)
SenderId String 80 Name of the Sender. NSPART

from:

remote_agent_ident (direct IN)

local_agent_ident (direct OUT)

MLHSERV (from DEST or ALTLOCN parameters)
RAppl String 80 Optional identifier of the Receiving  application. RAPPL rcv_appli N/A
SAppl String 80 Optional identifier of the Sending  application. SAPPL snd_appli N/A
SourceApplication String 100

The source application for a Central Governance flow, for monitoring purposes.

The source system is the system that initiates a flow.

SOURCEAPPL N/A N/A
TargetApplication String 100

The target application in a Central Governance flow, for monitoring purposes.

The target system is the system making a request to initiate the flow.

TARGETAPPL N/A N/A
FinalReceiverId String 80 Name of the final Receiver when using Store and Forward, otherwise the same as the ReceiverId. NDEST destination MLHBP
OriginalSenderId String 80 Name of the original Sender when using Store and Forward, otherwise the same as the SenderId. NORIG originator MLHORG1

Product identification

The product that sends the events is identified with the following:

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Location String 31 Unique and logical identifier for the product. PART parameter of the CFTPARM object. local_site_alias LOCNAME of PELPARMS
Monitor String 4 Product name. “CFT” MSG_PROD_MONITOR_PEL > "PEL" "PEL"
MonitorVersion String 25 Product version. Product version

Computation of:

MSG_XFB_MONITOR_VERSION > "6.6.3"

"732"
Machine String 25 Name of the application and platform that run on a Transfer CFT

PRODUCT_TYPE:

"CFT-UNIX" "CFTL-NT" "CFT-MVS" "CFT-400" "CFT-NSK" "CFT-VMS"

PRODUCT_TYPE:

"PEL-UNIX" "PEL-NT" "PEL-400" "PEL-NSK"

PELIMVS
ProductName String 50 N/A uconf: sentinel.trkproductname local_site_alias N/A

Transfer users

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
UserId String 25 Local identifier of the user who owns the transferred file. USERID N/A N/A
GroupId String 25 Local identifier of the group to which the transfer owner belongs. GROUPID N/A N/A
RequestUserId String 25 Local identifier of the user who requested the transfer. REQUSER username MLHUSERN
RequestGroupId String 25 Local identifier of the group to which the requesting user belongs. REQGROUP N/A N/A
Trustee String 25

If User Access Control is:

  • Activated for the transfer, the value of this attribute is the local identifier of the transfer owner (UserId).
  • Not activated for the transfer, the value of this attribute is the network identifier of the user who requested the transfer (RequestUserId).
IDAPPL N/A   N/A
RUser String 30 Optional local identifier of the user who received the transfer. RUSER rcv_user MLHUSERN
SUser String 30 Optional local identifier of the user who sent the transfer. SUSER snd_user N/A

Transfer identification

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
IdAppl String 25

If the value of the IsServer attribute is:

  • 0: The value of this attribute is the local identifier of the Requester.
  • 1: The value of this attribute is empty.
IDA N/A   auto PEL1
Application String 80 Local application/Transfer profile (ST). IDF application APPL
FileName String 512

If the value of the CommandType attribute is File and the value of the Direction attribute is:

  • E (Sender): This attribute identifies the file from which the Sender retrieved the transfer data (full path).
  • R (Receiver): This attribute identifies the file in which the Receiver recorded the transfer data (full path).
FNAME dir_path/file_component   DSNORIG
LocalId String 25

If the value of the Direction attribute is:

  • E (Sender): The value of this attribute is the local transfer identifier for the Sender.
  • R (Receiver): The value of this attribute is the local transfer identifier for the Receiver.
IDTU   local_ident   auto MLY_TRID
ProtocolFileName String 512

Network transfer identifier.

The Sender sent this identifier to the Receiver.

NIDF file_name N
ProtocolFileLabel String 80

The Sender sent this name to the Receiver.

The Receiver can use this name to locally name the transfer.

NFNAME file_label LABEL
ProtocolId String 80

Network transfer identifier.

The Sender generated this identifier.

The Receiver acknowledged this identifier.

NIDT xfer_ident MLHRANG
ProtocolMessage String 4000

If the value of the CommandType attribute is:

  • Message: The value of this attribute is the content of the transferred message.
  • File: This attribute is empty.
SMSG

From:

  • snd_msg (message OUT)
  • rcv_msg (message IN)

  MSG1/ MSG2

(Interpel MVS MSG1/MSG2/

MSG3/MSG4/

MSG5)

PositionNumber String 80

Local transfer identifier. If the value of the Direction attribute is:

  • E (Sender): The value of this attribute identifies the transfer in the Sender's transfer catalog or DB.
  • R (Receiver): The value of this attribute identifies the transfer in the Receiver's transfer catalog or DB.
IDT sequence   auto MLBCLE
ProtocolParameter String 512

Network transfer description.

The Sender sent this description to the Receiver.

PARM

from:

  • snd_msg (transfer OUT)
  • rcv_msg (transfer IN)

MSG1

(Interpel MVS MSG1/MSG2/

MSG3/MSG4/

MSG5)

UserParameter1 String 255

Local transfer description.

This description is recorded at the transfer request time in the local DB and remains local.

COMMENT param1 USERAREA
Flowname String 100 Parameter to define a flow name in Central Governance for monitoring purposes. Flowname (v3.1.x) N/A N/A
UserParameter2 String 255

Local transfer description.

This description is recorded at the transfer request time in the local DB and remains local.

N/A param2 N/A
VirtualDirName String 255 Virtual directory name N/A dir_name (not stored, always empty) N/A

Transfer validity periods

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
EarliestDate Date N/A Date on which the validity period begins. DATEM (Catalog) From date_to_begin: date SDATE {aaqqq | +n}
EarliestTime Time N/A Time at which the validity period begins. TIMEM (Catalog) From date_to_begin: time HSDEB
LatestDate Date N/A Date on which the validity period ends. DATEMAX (Catalog) From date_to_end: date N/A
LatestTime Time N/A Time at which the validity period ends. TIMEMAX (Catalog) From date_to_end: time HSFIN

Transfer dates and times

Sentinel Data type Length Description Name in InterPEL Core InterPEL MVS
CreationDate Date N/A

By default, the system date on which the Sender sent the transfer.

  • The Sender can set this date.
  • The Receiver can filter transfers based on this date.
From FDATE (Catalog) From hist_create_date: date CDATE=aaqqq
CreationTime Time N/A

By default, the system time at which the Sender sent the transfer.

  • The Sender can set this time.
  • The Receiver can filter transfers based on this time.
From FTIME (Catalog) From hist_create_date: time CTIME=hhmmss
SendDate Date N/A

If the value of the Direction attribute is:

  • E (Sender): The value of this attribute is the date on which the Sender recorded the transfer in the transfer catalog.
  • R (Receiver): The value of this attribute is the date on which the Receiver recorded the transfer in the transfer catalog. The Sender and the Receiver record each transfer only once.
From DATEK (Catalog) N/A N/A
SendTime Time N/A

If the value of the Direction attribute is:

  • E (Sender): The value of this attribute is the local time at which the Sender recorded the transfer in the transfer catalog.
  • R (Receiver): The value of this attribute is the local time at which the Receiver recorded the transfer in the transfer catalog.
The Sender and the Receiver record each transfer only once.
From TIMEK (Catalog) N/A N/A
AckDate Date N/A Date on which the Receiver acknowledged the transfer (if any). From Current Date when ack N/A N/A
AckTime Time N/A Time at which the Receiver acknowledged the transfer (if any).
StartDate Date N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is the date on which the Sender began sending the transfer.
  • RECEIVED: The value of this attribute is the date on which the Receiver began receiving the transfer.

These dates are expressed in dd.mm.yyyy format.

From DATEB (Catalog) From date_begin: date  (MVS) SDATE, MLHDATDT
StartTime Time N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is the local time at which the Sender began sending the transfer.
  • RECEIVED: The value of this attribute is the local time at which the Receiver began receiving the transfer.

These times are expressed in hh:mn:ss format.

From TIMEB (Catalog) From date_begin: time

  MLHHEUDT

(MVS does not exist in Pelica2 requests)

EndDate Date N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is the date on which the Sender stopped sending the transfer.
  • RECEIVED: The value of this attribute is the date on which the Receiver stopped receiving the transfer.

These dates are expressed in dd.mm.yyyy format.

From DATEE (Catalog) From date_end: date   MLHDATFT
EndTime Time N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is the local time at which the Sender stopped sending the transfer.
  • RECEIVED: The value of this attribute is the local time at which the Receiver stopped receiving the transfer.

These times are expressed in hh:mn:ss format.

From TIMEE (Catalog) From date_end: time   MLHHEUFT
RequestCreationDate Date N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is local date of the creation of the file on the Sender side.
  • RECEIVED: The value of this attribute is the date of the creation of the file on the Sender side.

ITP: transfer request creation date

From FDATE (Catalog) From date_create: date   MLHDATR
RequestCreationTime Time N/A

If the value of the State attribute is:

  • SENT: The value of this attribute is local time of the creation of the file on the Sender side.
  • RECEIVED: The value of this attribute is the time of the creation of the file on the Sender side.

ITP: transfer request creation time.

From FTIME (Catalog) From date_create: time   MLHTIMR
TransmissionDuration Integer N/A Transfer duration, expressed in seconds. From TIMES (Catalog) date_end-date_begin MLHDATDT - MLHDATFT

Transfer protocols

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Protocol String 25

Name of the protocol that operates at the Protocol Layer of the transfer. Possible values:

  • CFT (PeSIT, version CFT)
  • PSIT_HS_E (PeSIT, version E)
  • PSIT_HS_D (PeSIT, version D)
  • ODT (ODETTE File Transfer Protocol)
Protocol Type: "CFT "PSIT_HS_E" "ODT" "SFTP"

From protocol: "PSIT_HS_E"

"PSIT_HS_D"

"PEL"

"ETB3"

"ODT"

"ETB5V1"

"ETB5V2"

"FTP"

  MLHPROT
IsSSL String 1

1: SSL/TLS used for the transfer.

0: SSL/TLS not used for the transfer.

from SSLMODE (Catalog) cMode = C or S > "1"

cMode = "" > "0"

from sprof:

"0": empty

"1": not empty

MLHSSLPR
SSLAuth String 1
  • S: The Server sent X.509 certificates to the Requester.
  • B: Both the Server and the Requester sent X.509 certificates to each other.
  • N: Neither the Server nor the Requester sent X.509 certificates.
From SSLAUTH (Catalog) From client_auth , server_auth: same values   MLHSSLCA
SSLCypher String 2 The cipher suite that the Server and the Requester used during the SSL/TLS session. From SSLCIPH (Catalog) cipher_suite MLHSSLCS

Transfer options

Sentinel Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Compression String 1

One of the following:

  • 0: Undefined
  • 1: Horizontal
  • 2: Vertical
  • 3: Both horizontal and vertical
  • 4: Not compressed
  • 5: Zlib

From NCOMP (Catalog)

ncomp = 0: 4

0 < ncomp = < 8: 1

ncomp = 8: 2

8 < ncomp = < 16: 3

ncomp = 16: 5

From compression: same values   MLHCOMP
EOTProcedure String 255 Name of the end-of-transfer procedure executed upon the completion of the transfer. EXEC end_xfer_scriptpath N/A
Priority Integer N/A

Transfer priority. Receivers process transfers in the order of their priority.

The range of possible values for this attribute is 0 to 255.

The lowest priority is zero. The highest priority is 255.

PRI priority MLHPRIO
RetryMaxNumber Integer N/A Maximum number of times that the Sender can attempt to send transfers. RETRYM retry_count_max MLHRETMX
RetryNumber Integer N/A

Number of times that the Sender attempted to send the transfer.

Each time the Sender established a connection with the Receiver, the Sender counted one attempt.

RETRY retry_count MLHRETRY
RequestType String 1

One of the following:

  • S: The Sender sent a single transfer to a single Receiver.
  • F: The Sender sent a group of transfers to a single Receiver. For each transfer in the group, the product generated one Processing Cycle.
  • D: The Sender sent a single transfer to a group of Receivers (diffusion). For each Receiver in the group, the product generated one Processing Cycle.
  • P:  Cyclic transfer.

From DIFTYP and FILTYP (Catalog)

from type : "S", "D".   N/A
TransferType String 1

One of the following:

  • S: The Sender sent a single transfer to a single Receiver.
  • F: The transfer belongs to a group of transfers that the Sender sent to a single Receiver. For each transfer in the group, the product generated one Processing Cycle.
  • D: The Receiver belongs to a group of Receivers to whom the Sender sent the transfer (diffusion). For each Receiver in the group, the product generated one Processing Cycle.
Same as box above N/A (Gateway value)   MLHLDFKL
IsPermanent Char N/A Permanent transfer N/A perm N/A

Transfer size

Sentinel attribute Data type Length Description

Transfer CFT

InterPEL Core InterPEL MVS
FileSize Integer N/A

Size of the transferred file. This size is expressed in bytes.  

Note For PeSIT, an estimation of size is given at the beginning of the transfer. This value is updated upon completion of the transfer with the real value.
FCARS   file_size   MLHNBYTE
TransmittedBytes Integer N/A

Number of bytes transferred, after decompression, to transfer the file. This size is expressed in bytes.  

Note For PeSIT, this value sent is crosschecked by both the sender and receiver.
NCARS x_bytes MLHABYTE

Transfer structure and content

Sentinel attribute Data type Length Description

Transfer CFT

InterPEL Core InterPEL MVS
CommandType String 1
  • F: File transfer
  • M: Message transfer
  • A: Message reply
  • N: Message nack
TYPE type F or M (ack/nack is in "State")

TYPEREQ={S|C or M}

FileOrganization (ITP Core :FileOrganisation) String 25
  • org_sequential: The transferred data is not indexed.
  • indexed: The transferred data is indexed.
  • direct: The transferred data is assigned relative access.
FORG file_org GENFILE FORG={AUTO|SEQ|…}
FileType String 60 B: The transferred file is a binary file. FTYPE file_type GENFILE RECFM= {FB | … }
J, T, O, X: The transferred file is a text file.
RecordNumber Integer N/A

Number of record in the file. This size is expressed in bytes.  

Note For PeSIT, this value sent is crosschecked by both the sender and receiver.
FREC rec_count MLHNBRER
RecordFormat String 64
  • F: Fixed - The transferred data contains fixed-length records.
  • V: Variable - The transferred data contains variable-length records.
  • U: Undefined - The structure of the transferred data is unknown.
FRECFM

xfer_rec_fmt:

"F", "V",

"S": Stream

"T" : Text

  MLH1RECF
RecordSize Integer N/A

If the value of RecordFormat attribute is fixed, the value of this attribute is the size of all records in the transferred file, expressed in bytes.

If the value of RecordFormat is variable or undefined, the value of this attribute is the size of the largest record in the transferred file, expressed in bytes.

FLRECL rec_len GENFILE LRECL=nnn
Transcoding Integer (ITP Core : String) (ITP Core: 25)

Character code of the transferred data:

  • A: ASCII
  • B: Binary
  • E: EBCDIC
FCODE

From: xfer_data_code,data_code:

A/AT: ASCII (with Transco)

E/ET: EBCDIC (with Transco)

B/BT: Binary (with Transco)

U/UT: Undefined (with Transco)

  FILECODE {A|E|B}
TranslationTableId String 25 Name of the local translation table use during the transfer (if any). XLATE N/A (data_code, not set) N/A
BlockSize Integer N/A File block size (used by some OS) From FBLKSIZE (Catalog) block_size N/A

Other attributes

Sentinel attribute Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
IsRelay String 1

If transfer event comes from a relay site:

  • 1: Yes
  • 0: No
IsRelay N/A N/A
NodeId Integer   Identifier of the node that executes the transfer. NodeID N/A N/A
ParentCycleid String 250 The identifier of the event which is the parent of the current event. ParentCycleid N/A N/A
CycleId String 250 CycleId From TRKR (Catalog) symbolic variable &XFRCYCID this_cycle_id (not stored) MLHTKCID
InternalCycleId String 155 CycleID before hash. Not stored this_extended_cycle_id (not stored) Not stored
State String 20 Transfer state.

From: STATE,PHASE,

PHASESTEP,STATED,

DIRECT,DIAGI,FLAF

(Catalog):

"CONSUMED", "SENDING",

"SENT" "RECEIVING",

"RECEIVED", "TO_EXECUTE",

"CANCELED", "DELETED",

"SUSPENDED"

"INTERRUPTED", "CREATED",

"TO_ROUTE","ACKED", "ENDED_TO_ACK",

"AVAILABLE", "ROUTED","NACKED",

"ENDED_TO-NACK",

"PRE_PROC",

"PRE_PROC_ABORT",

"POST_PROC",

"POST_PROC_ABORT",

"POST_PROC-ACK",

"POST_PROC_ACK_ABORT",

"ACK_EXPECTED",

"COMPLETED",

"DELETED"

From state, direction, mode, user_processed, route_state:

"CONSUMED",

"SENDING",

"SENT"

"RECEIVING",

"RECEIVED",

"TO_EXECUTE",

"CANCELED",

"DELETED",

"SUSPENDED"

"INTERRUPTED",

"CREATED",

"TO_ROUTE",

"TO_SIGN",

"ACKED",

"ENDED_TO_ACK",

"AVAILABLE",

"ROUTED",

"ROUTE_FAILED"

MLHSTATU
ReturnCode String 20 Last transfer diagnostic. From DIAGI and DIAGP (Catalog) last_end_diag MLHPDTSE + MLHPDCSE
UserState String 20 Transfer user state. From APPSTATE (Catalog) user_state N/A

XFBLog tracked object

Sentinel attribute Data type Length Description Transfer CFT InterPEL Core InterPEL MVS
Monitor N/A N/A Monitor "XFB" See "Monitor" in Transfer object PEL
Product String 10 Product "CFT" See "Machine" in Transfer object PELIMVS
ProductName String 50 Product identifier N/A "XFBLog" INTERPELMVS
ApplicationName String 40 Application name PART from CFTPARM local_site_alias PELPARMS ID= or LOCNAME=
ReturnMessage String 512 N/A From Log text From Log text From Log text
EventDate Date N/A Creation date From log timestamp: date From log timestamp: date From log timestamp dd:mm:yyyy
EventTime Time N/A Creation time From log timestamp: time From log timestamp: time From log timestamp hh:mm:ss
RecDate Date N/A Record date From log timestamp: date From log timestamp: date From log timestamp dd:mm:yyyy
RecTime Time N/A Record time From log timestamp: time From log timestamp: time From log timestamp hh:mm:ss
IdentMsg String 10 Log message identifier From Log text (header) From Log Ident From Log Ident
IsEnd Integer N/A End of message. (multi-messages) N/A 1 N/A
SeverityClass String 10 N/A N/A

From log message severity:

"I" > "IG"

"W" > "AV"

"E" > "EC"

From log message severity:

"I" > "IG"

"W" > "AV"

"E" > "EC"

Severity Integer N/A N/A N/A

From log message severity:

"I" > 1

"W" > 2

"E" > 3

N/A
IsAlert Integer N/A Log message is an alert From log message severity: E,F > "1"

From log message severity:

"W",

"E" > "1"

From Alert indication

Related Links