Reference Information › Command Line Shell Reference Guide › Shell Commands › Service Endpoint Type Management

Service Endpoint Type Management

This section describes commands that manage the server endpoint types.

Note: These commands are planned for future development. There is not full support for these commands at this time.

This section contains the following topics:

svcpt_type.config

svcpt_type.create

svcpt_type.destroy

svcpt_type.list (3.7)

svcpt_type.lock

svcpt_type.unlock

svcpt_type.config

List the properties of a service endpoint type.

Syntax:

svcpt_type config /<catalog>:<svcpt_type> --boundary [--batch]

Parameters:

/<catalog>

Name of catalog in which the service endpoint type resides.

<svcpt_type>

Service endpoint type name.

--boundary

Display properties related to the service endpoint type's boundary.

--batch

Display output in UDL format.

svcpt_type.create

Create a service endpoint type from another service endpoint type.

Syntax:

svcpt_type create /<tgt catalog>:<tgt_svcpt_type> /<src catalog>:<src_svcpt_type>
                     [<.attr>=<value>]* [<property>[:<type>][:mandatory=1|=<default>]]*

Parameters:

/<tgt catalog>

Name of global catalog into which to create the service endpoint type.

<tgt_svcpt_type>

Target service endpoint name.

/<src catalog>

Name of global catalog in which the source service endpoint type resides.

<src_svcpt_type>

Source service endpoint type name.

<.attr>

Attribute name to set (currently the only supported attribute is .description).

<property>

Property name to set.

<type>

Property type - must be one of string, integer, ip_addr, or IP_owned. Note that this will default to string if the property is not inherited from the source svcpt_type.

mandatory=1

Specifies the property is mandatory.

=default

Specifies a default value for a property.

Examples:

svcpt_type create /svcpt_type:CICS_PROD /system:Generic_zOS_GW
                     service_host=my.prodhost.com service_port=5555
                     .description="Production CICS"

Create service endpoint type 'CICS_PROD' using service endpoint type 'Generic_zOS_GW'

svcpt_type create /svcpt_type:IMS_GW /system:Generic_zOS_GW
                     .description="IMS Gateway"
                     datastoreName metadataURL userID password

Create service endpoint type 'IMS_GW' using service endpoint type 'Generic_zOS_GW'

svcpt_type create /svcpt_type:IMS_TEST /svcpt_type:IMS_GW
                     service_host=my.testhost.com service_port=2345
                     .description="Test IMS" datastoreName=IO1A
                     metadataURL=class://samples.ims.openDb.AUTPSB11DatabaseView
                     userID=IMSCTLR password=IMSCTLR

Create service endpoint type 'IMS_TEST' using service endpoint type 'IMS_GW'

svcpt_type.destroy

Delete a service endpoint type and all its class volumes from a catalog.

Syntax:

svcpt_type destroy /<catalog>:<svcpt_type> [ --force ]

Parameters:

/<catalog>

Name of global catalog containing the service endpoint type.

<svcpt_type>

Name of the service endpoint type to be deleted.

--force

Skip the confirmation prompt.

Examples:

svcpt_type destroy /svcpt_type:DB2_GW

Destroy service endpoint type named DB2_GW in global catalog /svcpt_type

svcpt_type.list (3.7)

List service endpoint types

Syntax:

svcpt_type list /<catalog> [ --batch ]

Parameters:

/<catalog>

Global catalog to search

--batch

Display output in UDL format

Examples:

None.

svcpt_type.lock

Lock a service endpoint type.

Syntax:

svcpt_type lock /<catalog>:<svcpt_type> [pwd=-]

Parameters:

/<catalog>

Name of catalog in which the service endpoint type resides.

<svcpt_type>

Service endpoint type name.

pwd=

Prompt for the password used to unlock the class. If the standard input is not a terminal device, a prompt is not displayed and expects only one copy of the password on 'stdin' (this can be used for batch operations, to set the password from a file).

Examples:

svcpt_type lock /svcpt_type:DB2_GW

Lock service endpoint type

svcpt_type lock /svcpt_type:DB2_GW pwd=

Lock service endpoint type and prompt for password

Notes:

• The 'pwd' argument is required when executed by a non-maintainer.
• If the 'pwd' argument is specified, the specified password is required in order to unlock the service endpoint type.

svcpt_type.unlock

Unlock a service endpoint type

Syntax:

svcpt_type unlock /<catalog>:<svcpt_type> [pwd=-] [--override]

Parameters:

/<catalog>

Name of catalog in which the service endpoint type resides.

<svcpt_type>

Service endpoint type name.

pwd=

Prompt the user for the password that was provided when the class was locked. If the standard input is not a terminal device, a prompt is not displayed and expects only one copy of the password on 'stdin' (this can be used for batch operations, to set the password from a file).

--override

(for maintainers only) Override the lock on the class.

Examples:

svcpt_type unlock /svcpt_type:DB2_GW

Unlock service endpoint type

svcpt_type unlock /svcpt_type:DB2_GW pwd=

Unlock service endpoint type and prompt for password

svcpt_type unlock /svcpt_type:DB2_GW --override

Override the lock and unlock the service endpoint type

Notes:

• If the service endpoint type was locked with a password, the specified password must match
• If the service endpoint type was locked without a password, then only a maintainer may unlock the service endpoint type.