XFR - Function shipping request control block

    CONTROL BLOCK NAME = DFHXFRDS
    NAME OF MATCHING PLS CONTROL BLOCK = None
    DESCRIPTIVE NAME = CICS TS Function Request Shipping Request
                                 Control Block.
    MACROS = DFHXFSTG
    FUNCTION =
           Defines the data transformation (XF) control block
           as used in batch and online environments.
Table 1.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 0 DFHXFRDS
(0) FULLWORD 4 XFRBEGIN (2) ALLOW FOR USER STORAGE ACCOUNTING INFORMATION
(8) DBL WORD 8 XFRSTART (0) XF control block - start
         FIELDS IN THE XF CONTROL BLOCK THAT ARE UNIQUE
         TO AN ONLINE ENVIRONMENT
         NOTE: There is a copy of this storage up to XFRFLAGA in
         DFHEPC and up to XFRAADPT in DFHEIIC. These programs
         must also be changed if the offset of XFRFLAGA (or
         XFRAADPT for DFHEIIC) changes. The field names in these
         programs are TFRFLAGA and TFRAADPT.
               SYSTEM/SESSION RELATED FIELDS
(8) CHARACTER 4 XFRSYSNM N(SYSID)
(C) ADDRESS 4 XFRATCSE A(TCTSE)
(10) ADDRESS 4 XFRATCTE A(TCTTE) OR 0
(14) ADDRESS 4 XFRATIOA A(TIOA) OR 0
(18) CHARACTER 4 XFRLUCCD LU6.2 ERROR (SENSE) CODE
(1C) CHARACTER 4 XFRSTRAN Server transaction code
(20) BITSTRING 1 XFRFLAGA
(20) 1... ....   XFRSERVR "X'80'" Server transaction supplied
(20) .1.. ....   XFRNORM "X'40'" Normal transformer to be used
(20) ..1. ....   XFRSYNC "X'20'" SYNCONRETURN requested
(20) ...1 ....   XFRNOATN "X'10'" CONVERSE with NOATNI required
(20) .... 1...   XFRLINK "X'08'" LINK request
(20) .... .1..   XFRRTDST "X'04'" Dynamically routed START request
(20) .... ..1.   XFRRESUN "X'02'" RESUNAVAIL condition supported
(20) .... ...1   XFRCHAN "X'01'" CHANNEL request
(22) HALFWORD 2 XFRRTRLN Length of router commarea or 0
(24) ADDRESS 4 XFRRTRAD A(DFHDSRP) or 0
(28) BITSTRING 4 XFRCHTOK Channel Token
(2C) BITSTRING 1 XFRFLAGB
(2C) 1... ....   XFRRSTRT "X'80'" dynamic and routable start
(2D) BITSTRING 1   reserved
(2E) HALFWORD 2 XFRADPLN Length of adapter data
(30) ADDRESS 4 XFRAADPT Address of adapter data
(34) FULLWORD 4 XFRFSPEC (0) Origin for function specific storage
               DL/I RELATED FIELDS
(34) ADDRESS 4 XFRAUIB A(UIB)
(38) FULLWORD 4 XFRDLILN Maximum length os SETS I/O area so far
               FILE CONTROL RELATED FIELDS
(3C) FULLWORD 4 FCBUFLEN Shipped buffer length
(40) HALFWORD 2 FCKEYLEN Shipped record identifier length
(42) BITSTRING 1 FCEID (9) ARG 0 OF EIP PARAMETER LIST (EID)
(4B) BITSTRING 1   RESERVED
               TRANSACTION ENTRY POINT RELEATED FIELDS
(4C) FULLWORD 4 XFRATACD Addr. of TRANSACTION EP ACD
(50) HALFWORD 2 XFRLTACD Length of TRANSACTION EP ACD
(52) BITSTRING 1 (10) RESERVED
(5C) FULLWORD 4 (0) MAKE LENGTH MULTIPLE OF 4
    This DSECT describes the entries required for remote program link
(5C) FULLWORD 4 DFHPCENT (0) PC LINK entries begin here
(5C) CHARACTER 4 XFR_PC_ATT_TRAN Transaction code - for mirror attach FMH
(60) CHARACTER 4 XFR_PC_EIB_TRAN Transaction code - for mirror EIBTRNID
(64) FULLWORD 4 XFR_PC_CCSID Character data conversion 0 => no conversion -1 => conversion required use client code page defined via DFHCNV n => conversion requird use n as override to code page defined via DFHCNV
(68) FULLWORD 4 XFR_PC_NDIAN Binary data conversion 0 => no conversion X'01020304' => data held in big endian format X'04030201' => data held in little endian format
(6C) CHARACTER 8 XFRPNAME name of program
(74) HALFWORD 2 XFRCOMML length of commarea
(76) HALFWORD 2 XFRDATAL length of data to be sent
(78) CHARACTER 4 XFRABCD Abend code returned from mirror
(7C) BITSTRING 1 XFRFLAG4 Flag byte
(7C) 1... ....   XFRHTRAN "X'80'" hex tranid present
(7C) .1.. ....   XFRDATAV "X'40'" valid DATALENGTH supplied
(7C) 1111 ....   ESCARGN "240" Special id for escape sequence
   Fields used for passing terminal error information between
   MIRS/ISP and the transformer
(7D) BITSTRING 4 XFRTCERR Terminal error
(81) CHARACTER 4 XFRTCABE Terminal control abend code
(85) BITSTRING 4 XFRTCSNS Terminal control sense data
(90) DBL WORD 8 CONTAINER_LIST (0)
(90) ADDRESS 4 CONTAINER_LIST_P Address of container list
(94) FULLWORD 4 CONTAINER_LIST_N Length of container list
(98) FULLWORD 4 XFRCHOUT # outbound channel bytes
(9C) FULLWORD 4 XFRCHIN # inbound channel bytes
         FIELDS IN THE XF CONTROL BLOCK THAT ARE UNIQUE
         TO A BATCH ENVIRONMENT
(8) ADDRESS 4 XFRASTG1 ADDRESS OF STG CONTAINING THE FLATTENED PLIST. THE TRANSFORMER GETS NEW STG IF XFRASTGE IS 0 OR REUSES THE CURRENT STG IF THIS PROVES LARGE ENOUGH
(C) ADDRESS 4 XFRASTG4 ADDRESS OF THE FLATTENED REPLY IN THE BUFFERS OF BATCH DL/I.
(10) FULLWORD 4 XFRASTGL LENGTH OF THE FLATTENED REPLY IN THE DL/I BUFFERS
         FIELDS IN THE XF CONTROL BLOCK THAT ARE COMMON
         TO A BATCH AND ONLINE ENVIRONMENTS
(A0) ADDRESS 4 XFRPLIST ADDRESS OF PLIST PASSED TO TRANSFORMER OR ADDRESS OF PLIST CREATED BY TRANSF'R
(A4) ADDRESS 4 XFRATABN A(1ST TABLE ENTRY) OR 0 - E.G. RPDIR OR DCTTE
(A8) ADDRESS 4 XFRATAB2 A(2ND TABLE ENTRY) - E.G. PDIR OR 0
(AC) CHARACTER 1 XFRFORMN THE TRANSFORMER INDEX - WITH VALUES SET AS FOLLOWS
(AC) .... ....   XFRTRAN1 "0" TRANSFORMER 1 - VERTICAL TO HORIZONTAL REQUESTS
(AC) .... ..1.   XFRTRAN2 "2" TRANSFORMER 2 - HORIZONTAL TO VERTICAL REQUESTS
(AC) .... .1..   XFRTRAN3 "4" TRANSFORMER 3 - VERTICAL TO HORIZONTAL REPLIES
(AC) .... .11.   XFRTRAN4 "6" TRANSFORMER 4 - HORIZONTAL TO VERTICAL REPLIES
(AD) CHARACTER 2 XFRARCHD USED TO SHOW CICS OR SNA ARCHITECTURE WHEN A CHOICE IS AVAILABLE
(AF) CHARACTER 1 XFRGROUP THE GROUP IDENTIFIER FOR THE CURRENT REQUEST
(AF) .... .11.   XFRFCGRP "X'06'" - THE CICS FC GROUP
(AF) .... 1...   XFRTDGRP "X'08'" - THE CICS TD GROUP
(AF) .... 1.1.   XFRTSGRP "X'0A'" - THE CICS TS GROUP
(AF) ...1 ....   XFRICGRP "X'10'" - THE CICS IC GROUP
(AF) ...1 .1..   XFRJCGRP "X'14'" - THE CICS JC GROUP
(AF) .1.. ....   XFRDLGRP "X'40'" - THE DL/I GROUP
(B0) CHARACTER 1 XFRFUNCT THE FUNCTION IDENTIFIER FOR THE CURRENT REQUEST
(B1) CHARACTER 1 XFRFLAGS PARAMETER LIST FLAGS - WITH VALUES SET AS FOLLOWS
(B1) 1... ....   XFREILST "X'80'" THE ARGUMENT LIST COMES FROM OR GOES TO EIP
(B1) .1.. ....   XFRDLLST "X'40'" THE ARGUMENT LIST COMES FROM OR GOES TO DL/I
(B1) ..1. ....   XFRDLCNT "X'20'" FIRST ARGUMENT IS A COUNT OF THE REMAINING ARGUMENTS
(B1) ...1 ....   XFRDLPLI "X'10'" THE DL/I REQUEST COMES FROM PL/I - INDIRECTION EXISTS
(B1) .... 1...   XFRATHDR "X'08'" AN ATTACH HEADER HAS BEEN PUT OUT BEFORE OTHER DATA
(B1) .... .1..   XFRLNGRN "X'04'" THE MIRROR TASK NEEDS TO BE LONG RUNNING
(B1) .... ..1.   XFRNRPLY "X'02'" THE REQUEST IS TO BE SHIPPED; HOWEVER NO REPLY IS EXPECTED
(B1) .... ...1   XFRPRTCT "X'01'" THE REQUEST IS TO BE SHIPPED PROTECTED
(B2) CHARACTER 1 XFRFLAG1 PARAMETER LIST FLAGS - WITH VALUES SET AS FOLLOWS
(B2) 1... ....   XFRLCLQ "X'80'" THE REQUEST MAY BE QUEUED BEFORE SHIPPING
(B2) .1.. ....   XFRFCTK "X'40'" FC Token can be shipped
(B2) ..1. ....   XFRFCRQ "X'20'" Shipped FC request
(B2) ...1 ....   XFRTMERR "X'10'" Terminal error in xformer layer
(B2) .... ..1.   XFRESCAP "X'02'" Escape sequence preceding 4-byte legths may be found
(B2) .... ...1   XFRCHANL "X'01'" This is a CHANNEL request
(B3) CHARACTER 1 XFRFLAG2 PARAMETER LIST FLAGS - WITH VALUES SET AS FOLLOWS
(B3) 1... ....   XFRHAENT "X'80'" DFHMIRVM has handled an abend; the abend code is to be found in the TACB
(B3) .1.. ....   XFRLENFD "X'40'" LENGTH parameter forced for a FILE READ request which didn't specify LENGTH parameter originally
(B3) ..1. ....   XFRCHNSP "X'20'" Other end of MRO link supports channels
(B3) ...1 ....   XFRICRX "X'10'" Other end of MRO link supports ICRXs
(B3) .... 1...   XFRLCHAN "X'08'" Link with prog or tran chan
(B3) .... .1..   XFRCACX "X'04'" Other end supports propagation of current app ctxt
(B3) .... ..1.   XFRODRP "X'02'" Other end supports propagation of Origin Data
(B3) .... ...1   XFRACTX "X'01'" Other end supports propagation of initial app ctxt
(B4) CHARACTER 1 XFRFLAG3 PARAMETER LIST FLAGS - WITH ALL VALUES RESERVED
(B5) CHARACTER 2 XFRCODES (0) FLAGS INDICATING WHERE CONTROL IS TO BE PASSED UPON RETURN FROM THE TRANSFORMER
(B5) CHARACTER 1 XFRCODE1 THE FIRST SET OF FLAGS - THE NEXT DEFINITIONS APPLY TO RETURN FROM TRANSFORMERS 1 AND 4 WITH VALUES SET AS FOLLOWS
(B5) .... .1..   XFR1TO4 "4" TRANSFORMER 1 HAS FOUND AN ERROR - CONTROL IS TO BE PASSED TO TRANSFORMER 4
(B5) .... 1...   XFR1TOC "8" TRANSFORMER 1 HAS FOUND ERROR - CONTROL IS TO BE PASSED BACK TO EIP OR DL/I
(B5) .... ..1.   XFR1XLNF "2" XLN failure THE NEXT DEFINITIONS APPLY TO RETURN FROM ISP WITH VALUES SET AS FOLLOWS
(B5) 11.1 1.11   XFRLNKUN "219" RESUNAVAIL condition raised in remote region
(B5) ...1 111.   XFRLNKAP "30" Allocate request in ISP has been purged
(B5) ...1 11..   XFRLNKAR "28" Allocate request in ISP has been rejected
(B5) ...1 1.1.   XFRLNKNI "26" no sessions immediately available for allocate request
(B5) ...1 1...   XFRLNKPF "24" ALLOCATE IN ISP HAS FAILED BECAUSE PROFILE DFHCICSF IS MISSING
(B5) ...1 .11.   XFRLNKSV "22" TRANSID invalid, we are already in session with a different mirror transaction.
(B5) ...1 .1.1   XFRDWNLV "21" The remote system does not support a keyword on this request
(B5) ...1 .1..   XFRLNKGP "20" ALLOCATE IN ISP HAS FAILED BECAUSE THE MODENAME IS INVALID
(B5) ...1 ..1.   XFRLNKSP "18" SYNCONRETURN invalid, we are already in session with a mirror
(B5) ...1 ....   XFRLNKLQ "16" LOCAL QUEUEING HAS FAILED - BAD RETURN FROM DFHICP TYPE=PUT
(B5) .... 111.   XFRLNKAB "14" xform 4 has processed ABCODE data
(B5) .... 11..   XFRLNKNA "12" ALLOCATE IN ISP HAS FAILED BECAUSE THE LINK IS NOT IN THE INTERSYSTEM TABLE
(B5) .... 1.1.   XFRLNKSF "10" CONVERSE in DFHISP has failed
(B5) .... 1..1   XFRLNKCP "9" Special for CPSM only equ of XFRLNKSH.
(B5) .... 1...   XFRLNKSH "8" ALLOCATE IN ISP HAS FAILED BECAUSE THE LINK, THOUGH EXISTING, IS OUT OF SERVICE
(B5) .... .11.   XFRLNKNS "6" Type of request (either LINK or START CHANNEL) is not supported over LU6.1 connections
(B5) .... .1..   XFRLNKSY "4" ALLOCATE IN ISP HAS FAILED BECAUSE NAME IS NOT THAT OF TCTSE
(B6) CHARACTER 1 XFRCODE2 THE SECOND SET OF FLAGS - APPLY TO RETURN FROM TRANSFORMERS 2 AND 3 WITH VALUES SET AS FOLLOWS
(B6) .... .1..   XFR2TO3 "4" TRANSFORMER 2 HAS FOUND AN ERROR - CONTROL IS TO BE PASSED TO TRANSFORMER 3
(B6) .... 1...   XFRNEGR "8" TRANSFORMER 2 HAS FOUND AN ERROR - A NEGATIVE RESPONSE IS TO BE SENT
(B7) CHARACTER 1 XFRABCDE ABEND CODE INDICATOR PASSED BACK FROM THE TRANSFORMER TO THE BATCH CONTROLLER PROGRAM
(B8) ADDRESS 4 XFRRESR9 resumption base for DL/I function shipping
(BC) ADDRESS 4 XFRRESRE resumption address for DL/I function shipping
(C0) ADDRESS 4 XFRBEGOP address of Arg0 options bytes
(C4) FULLWORD 4 XFRARGS (0) ORIGIN FOR ARGUMENTS
(C4) 1.11 11..   XFRLNGTH "*-XFRSTART"
         STORAGE USED BY TRANSFORMER 2 TO CONSTRUCT
         A PARAMETER LIST FOR EXEC OR DL/I REQUESTS.
         THIS STORAGE IS APPPENDED TO THE XF CONTROL
         BLOCK ADDRESSED FROM TCAXFS23 (IT IS ONLY
         NEEDED IN A MIRROR ENVIRONMENT)
(C4) FULLWORD 4 (96) see comment above
(C4) 0 XFRLNG2 "*-XFRSTART"


DFHXFSGK.html | Timestamp icon Last updated: Sunday, 4 June 2017