The resources are a DTCN profile and a DTCN profile repository.
The following list describes how
z/OS® Debugger abstracts
a DTCN profile and a DTCN profile repository as a Uniform Resource
Identifier (URI):
- DTCN profile
http://ip/dtcn/profileID- DTCN profile repository
http://ip/dtcn
The following table describes each symbol in the URI:
Table 1. Description of each symbol in the URI
| Symbol |
Description |
| ip |
The IP address and port number of the CICS® HTTP server. |
| dtcn |
Name of the profile collection, which must be dtcn. |
| profileID |
A key which identifies a specific profile. This
is the TSO user ID of the owner of the DTCN profile. |
You can use a query string to provide additional information,
the client version, and a profile record number to the DTCN profile
manager. You specify a query string by adding a delimiter (the
question mark, ?) after the resource name. The following table describes
the symbols you can use in the query string:
Table 2. Description
of each symbol in the query string
| Symbol |
Description |
| clientversion=nnnn |
A four digit decimal number that identifies
the version of the API that you are using in your application. To
learn how to identify version numbers and determine compatibility,
see Compatibility of different versions. |
| s=number |
A decimal number that identifies a profile in
the profile repository. The DTCN profile manager numbers profile records
in the repository in sequence beginning with 1. |
The following examples describe how you might write an URI with
a query string:
- http://yourhost.yourcompany.com:30000/dtcn/userjoe?clientversion=0102
- Identifies a DTCN profile stored in the host
yourhost and
owned by user userjoe.
- http://anotherhost.yourcompany.com:30000/dtcn?clientversion=0102&s=1
- Use this URI with the GET method to retrieve up to the first 10
profiles starting with profile record 1 in the DTCN profile repository
on the host
anotherhost.