WSAEPR CREATE

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.