DFHCNV TYPE=ENTRY
This is the format of the DFHCNV TYPE=ENTRY macro instruction.
- TYPE=ENTRY
- Specifies that this macro defines a resource by name and type.
- RTYPE={FC|TS|TD|IC|PC}
- Specifies the type of resource:
- FC
- A file
- TS
- A temporary storage queue
- TD
- A transient data queue
- IC
- An interval control start with data
- PC
- A program link with a COMMAREA.
- CLINTCP={nnnn[,nnnn, ...]|SYSDEF}
- The first operand defines the default client code page to be used.
SYSDEF specifies that the default client code page is determined by the system initialization table parameter CLINTCP.
For an explanation of code pages, and a list of those that you can specify, see Character data.
- SRVERCP={nnnn|SYSDEF}
- The operand defines the server code page to be used.
SYSDEF specifies that the server code page is determined by the system initialization table parameter SRVERCP.
For an explanation of code pages, and a list of those that you can specify, see Character data.
- RNAME=resourcename
- Specifies the name of the resource in up to eight characters.
If shorter, it is padded with blanks; if longer, it is truncated.
The name can be:
- A FILE name (up to eight characters).
- A TS queue name (up to eight characters). Note: Although CICS supports TS queue names of up to16 characters, DFHCNV only supports TS queue names of up to 8 characters.
- A TD queue name (up to four characters).
- An IC start transaction id (up to four characters).
- The name of the program being linked (up to eight characters).
- RPFX=resourceprefix
- Specifies a resource prefix of up to 7 characters for programs, TS queues and files; or 3 characters for TD queues and transactions. The resource prefix allows resources of a particular type to be grouped together using just one macro. All resources of the specified type and prefix will be treated in the same way. Order is important, so the most specific resource names should be at the top of the conversion table, with the least specific prefixes at the bottom. If none of the parameters are specified at this point in the macro, the default template is used for all resources within the specified resource type.
- XRNAME=xxxxxxxxxxxxxxxx (RTYPE=TS only)
- Specifies the resource name in hexadecimal notation. It can include up to 16 hexadecimal digits, padded with blanks if necessary.
- XRPFX=xxxxxxxxxxxxxx (RTYPE=TS only)
- Specifies a resource prefix of up to 14 hexadecimal digits. The resource prefix allows resources of a particular type to be grouped together. All resources of the specified type and prefix will be treated in the same way. The sequence is important, so the most specific resource names should be at the top of the conversion table, with the least specific prefixes at the bottom. If none of the parameters are specified at this point in the macro, the default template is used for all resources within the specified resource type.
- USREXIT={YES|NO∨program}
- Specifies whether the user data conversion exit is called.
- YES
- User-defined conversion is required for this resource. DFHUCNV is invoked. Code this if you need your customized version of DFHUCNV to convert some data for this resource.
- NO
- User-defined conversion is not required for this resource. The user-replaceable conversion program is not called. Code this to eliminate the overhead of calling the program unnecessarily.
- program
- User-defined conversion is required for this resource; program is invoked. Code this if you need your user-supplied program, program, to convert some data for this resource.
- CDEPAGE=nnnn
- Restriction: Do not use this parameter for new definitions. It is supported only for compatibility with earlier releases.
The code page must be one of those entered in the CDEPAGE option of the DFHCNV TYPE=INITIAL macro. Each possible value is equivalent to a pair of CLINTCP and SRVERCP entries or (for user-defined conversion) to a SRVERCP entry. The CLINTCP and SRVERCP values to which each value resolves are given in the description of the CDEPAGE option of the DFHCNV TYPE=INITIAL macro.