CEMT INQUIRE XMLTRANSFORM
Retrieve information about an installed XMLTRANSFORM resource.
In the CICS Explorer, the XML transforms operations view provides a functional equivalent to this command.
The resource signature
You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.
Input
- Type
CEMT INQUIRE XMLTRANSFORM
. You get a screen that lists the current status. - Type
CEMT INQUIRE XMLTRANSFORM
followed by as many of the other attributes as are necessary to limit the range of information that you require. So, for example, if you enterCEMT INQUIRE XMLTRANSFORM EN
, the resulting display shows you the details of only those resources that are enabled.
- Overtype your changes on the INQUIRE screen after tabbing to the appropriate field.
- Use the CEMT SET XMLTRANSFORM command.
- ALL
- is the default. Information about all XMLTRANSFORM resources is displayed, unless you specify a selection of resources to be queried.
- (value)
- is the name (1-32 characters) of an installed XMLTRANSFORM resource.
If you place the cursor against a specific entry in the list and press ENTER, CICS® displays an expanded format of all the attributes for the specified XMLTRANSFORM resource.
Displayed fields
- CCSID(value)
- Displays the CCSID that is used to encode data the character data in the application data structure at run time. This value is set using the optional CCSID parameter in the XML assistant when the XML binding file is generated. If the value is 0, CICS uses the default CCSID that is specified by the LOCALCCSID system initialization parameter.
- CHANGEAGENT(value)
- Displays a value that identifies the agent that made the last change to the resource definition.
You cannot use CEMT to filter on some of these values because they are duplicated. The possible
values are as follows:
- CREATESPI
- The resource definition was last changed by an EXEC CICS CREATE command.
- CSDAPI
- The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
- CSDBATCH
- The resource definition was last changed by a DFHCSDUP job.
- DREPAPI
- The resource definition was last changed by a CICSPlex SM BAS API command.
- DYNAMIC
- The resource was defined by an ATOMSERVICE resource.
- CHANGEAGREL(value)
- Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
- CHANGETIME(date time)
- Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- CHANGEUSRID(value)
- Displays the 8-character user ID that ran the change agent.
- DEFINESOURCE(value)
- Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
- DEFINETIME(date time)
- Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- ENABLESTATUS(value)
- Displays
the status of the installed XMLTRANSFORM resource. The possible values
are:
- ENABLED
- The XMLTRANSFORM resource is enabled for use.
- DISABLED
- The XMLTRANSFORM resource is disabled.
- INSTALLAGENT(value)
- Displays a value that identifies the agent that installed the resource. The possible values are
as follows:
- BUNDLE
- The resource was installed by a bundle deployment.
- DYNAMIC
- The resource was installed by an ATOMSERVICE resource.
- INSTALLTIME(date time)
- Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- INSTALLUSRID(value)
- Displays the 8-character user ID that installed the resource.
- MAPPINGLEVEL(value)
- Displays the mapping level that was used when the XML binding file was generated. The value of the mapping level is 1.0, 1.1, 1.2, 2.0, 2.1, 2.2, or 3.0.
- MINRUNLEVEL(value)
- Displays the minimum runtime level that is required to use the XMLTRANSFORM resource in CICS. The value of the runtime level is 3.0.
- VALIDATIONST(value)
- Displays
whether full validation is currently enabled for this XMLTRANSFORM
resource:
- VALIDATION
- Full validation is enabled
- NOVALIDATION
- Full validation is not enabled.
- XMLSCHEMA(value)
- Displays the name of the XML binding file. The name can be up to 255 characters long.
- XSDBIND(value)
- Displays the name of the XML binding file. The name can be up to 255 characters long.