Use the WSAEPR CREATE command
to create an endpoint reference (EPR) to represent a Web service or
Web service resource.
![Read syntax diagram](../c.gif)
WSAEPR CREATE
>>-WSAEPR CREATE------------------------------------------------>
>--+-EPRINTO(data-area)-+--EPRLENGTH(data-area)----------------->
'-EPRSET(data-area)--'
.--------------------------------------------------.
V |
>----+-ADDRESS(data-value)--------------------------+-+--------->
+-REFPARMS(data-value)-REFPARMSLEN(data-value)-+
'-METADATA(data-value)-METADATALEN(data-value)-'
>--+--------------------------+--------------------------------><
+-FROMCCSID(data-value)----+
'-FROMCODEPAGE(data-value)-'
Conditions: CCSIDERR, CODEPAGEERR, INVREQ, LENGERR
This command is threadsafe.
Description
The WSAEPR CREATE command
creates an endpoint reference, which can represent a Web service or
Web service resource. You can send this EPR to a client so that the
addressing context is used for requests to the service.
Options
- ADDRESS(data-value)
- Specifies a URI that forms the address of the endpoint reference.
The value of this option must be 255 characters in length. If the
URI is less than 255 characters, you must pad the data value with
trailing blanks.
- The default address of http://www.w3.org/2005/08/addressing/anonymous returns
information to the caller of the command. Use an address of http://www.w3.org/2005/08/addressing/none if
no request or response is required. If the To EPR contains a URI,
the SOAP message is sent to this URI. If the ReplyTo or FaultTo EPRs
contain a URI, response messages are sent to the Web service using
that URI and not back to the sender of the request message.
- EPRINTO(data-area)
- Specifies the data area used to contain the generated endpoint
reference. The EPRINTO and EPRSET options are mutually exclusive.
- If the EPRINTO option contains an address, any special characters
in the address are automatically escaped or unescaped.
The following characters in an address are replaced with
an escape sequence: ", >, <, ', &
|
- EPRLENGTH(data-area)
- Specifies the length, as a halfword binary value, of the endpoint
reference.
- If you specify the EPRINTO option, you must specify a value for
EPRLENGTH unless the length can be generated by the compiler from
the EPRINTO option.
- The EPRLENGTH option defines the maximum length of data that the
program accepts. If the value specified is less than zero, zero is
assumed. If the length of the data exceeds the value specified, the
data is truncated to that value and the LENGERR condition occurs.
- EPRSET(ptr-ref)
- Specifies the pointer reference that is set to the address of
the output data area used to contain the complete or partial endpoint
reference. The pointer reference, unless changed by other commands
or statements, is valid until the next WSACONTEXT GET command
or the end of the task. The EPRINTO and EPRSET options are mutually
exclusive.
- FROMCCSID(data-value)
- Specifies the current Coded Character Set Identifier (CCSID) of
the character data to be read or written as a fullword binary number. If
you prefer to specify an IANA name for the code page, or if you prefer
to specify the CCSID as alphanumeric characters, use the FROMCODEPAGE
option instead.
For CICS® Transaction Server for z/OS® applications,
the CCSID is typically an EBCDIC CCSID.
The default CCSID of
the region is specified on the LOCALCCSID system initialization option.
For
an explanation of CCSIDs, and a list of the CCSIDs supported by CICS,
see CICS-supported conversions .
- FROMCODEPAGE(data-value)
- Specifies an IANA-registered alphanumeric charset name or a Coded
Character Set Identifier (CCSID) for the current code page of the
character data to be read or written using up to 40 alphanumeric characters,
including appropriate punctuation. Use this option instead of the
CCSID option if you prefer to use an IANA-registered charset name,
as specified in the Content-Type header for an HTTP request. CICS
converts the IANA name into a CCSID, and the subsequent data conversion
process is identical. Also use this option if you prefer to specify
the CCSID in alphanumeric characters, rather than as a fullword binary
number.
Where an IANA name exists for a code page and CICS supports
its use, the name is listed with the CCSID in CICS-supported conversions .
- METADATA(data-value)
- Specifies metadata that describes the behavior, policies, and
capabilities of the endpoint targeted by the endpoint reference. The
metadata must be described in XML.
- METADATALEN(data-value)
- Specifies the length, as fullword binary, of the METADATA option.
- REFPARMS(data-value)
- Specifies application reference options that form part of the
endpoint reference. These options are described in XML.
- REFPARMSLEN(data-value)
- Specifies the length, as fullword binary, of the reference options.
Conditions
- 123 CCSIDERR
- RESP2 values:
- 1
- The CCSID specified on the FROMCCSID option is outside the range
of valid CCSID values.
- 2
- The CCSID specified on the FROMCCSID option and the CCSID of the
container are an unsupported combination.
- 5
- There was an internal error in the code page conversion of a container.
- 6
- Either the text encoding is not compatible with the specified
CCSID on the FROMCCSID option, or one or more characters are truncated.
- 125 CODEPAGEERR
- RESP2 values:
- 1
- The code page specified on the FROMCODEPAGE option is not supported.
- 2
- The code page specified on the FROMCODEPAGE option and the CCSID
of the container are an unsupported combination.
- 5
- There was an internal error in the code page conversion of a container.
- 6
- Either the text encoding is not compatible with the specified
CODEPAGE on the FROMCODEPAGE option, or one or more characters are
truncated.
- 16 INVREQ
- The INVREQ RESP2 values and the corresponding messages are shown
below. For this command, if the EIBRESP2 value is > 100, the fullword
EIBRESP2 field is regarded as a structure containing two halfwords.
The low-order halfword always contains the error number. The high-order
halfword contains the offset into the XML data where the parsing error
occurred.
- RESP2 values:
- 8
- One of the input parameters contains an incorrect value. The ADDRESS
option might not contain a valid URI.
- 13
- One of the input parameters contains an incorrect value. The METADATA
option might not contain valid XML.
- 14
- One of the input parameters contains an incorrect value. The REFPARMS
option might not contain valid XML.
- 22 LENGERR
- RESP2 values:
- 20
- This condition occurs when the length of the stored data is greater
than the value specified by the EPRLENGTH option. This condition only
applies to the EPRINTO option and cannot occur with the EPRSET option.
- Default action: ends the task abnormally.