DFHMAH header structure

Stabilized feature: Service Flow Runtime and Service Flow Modeler capability in IBM Developer for z/OS 14.2.3 are stabilized. Consider exposing and orchestrating applications as API services by using z/OS Connect Enterprise Edition or CICS® web services, or by writing web applications in Java or Node.js. See also Stabilization notices and discontinued functions.

The request message header DFHMAH describes the structure of the application data. It is mapped by copybook DFHMAHV, which is in the library SCIZMAC.

The following table highlights field information in the message header structure DFHMAH.

A field's type can be one of the following:
X
The field contains characters.
9
The field is a numeric
FB
The field is a fullword binary.
Table 1. DFHMAH message header fields
Disp. Length Type Field Req. Values
0 04 x DFHMAH-STRUCID Y
MAH
'<?XM', '<?xm'
'<SOA', '<soa'
4 04 FB DFHMAH-VERSION Y 1
8 04 FB DFHMAH-STRUCLENGTH Y 384
12 08 x DFHMAH-USERID N  
20 08 x DFHMAH-FORMAT N Spaces
28 04 FB DFHMAH-RETURNCODE N  
32 04 FB DFHMAH-COMPCODE N  
36 04 FB DFHMAH-MODE N  
40 04 FB DFHMAH-SUSPSTATUS N  
44 04 x DFHMAH-ABENDCODE N  
48 08 x DFHMAH-MESSAGE N  
56 04 x DFHMAH-MSG-RESERVED N  
60 04 FB DFHMAH-UOWCONTROL Y zero, 1, 2, 9
64 08 x DFHMAH-PROCESSTYPE Y
72 36 x DFHMAH-PROCESSNAME N
108 08 x DFHMAH-REQUESTNAME Y  
116 04 FB DFHMAH-DATALENGTH Y  
120 36 x DFHMAH-FAILED-PROCNAME N  
156 08 x DFHMAH-FAILED-PROCTYPE N  
164 04 x DFHMAH-FAILED-TRANID N  
168 48 x DFHMAH-REPLYTOQ N  
216 48 x DFHMAH-REPLYTOQMGR N  
264 24 x DFHMAH-MSGID N  
288 24 x DFHMAH-CORRELID N  
312 08 x DFHMAH-FAILED-PROGRAM N  
320 32 x DFHMAH-FAILED-NODE N  
352 04 FB DFHMAH-LINKTYPE N Reserved.
356 04 FB DFHMAH-MORE-DATA-IND N  
360 04 FB DFHMAH-BRIDGE-RC N  
364 16 x DFHMAH-STATETOKEN N  
380 04 x DFHMAH-RESERVED2 N Reserved.