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

Service Endpoint Management

This section describes commands that manage the server endpoints within a grid.

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.config

List the properties of a service endpoint.

Syntax

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

Parameters

/<catalog>: Name of catalog in which the service endpoint resides.
<svcpt>: Service endpoint name.
--boundary: Indicates properties related to the service endpoint boundary.
--batch: Display output in UDL format.

Examples:

svcpt config /svcpt:CICS_PROD --boundary

Display boundary configuration for service endpoint.

:svcpt.create

Create a service endpoint from a model service endpoint type.

Syntax:

svcpt create /<svcpt catalog>:<svcpt> /<svcpt_type catalog>:<svcpt_type> [<.attr>=<value>]* [<property>=<value>]*

Parameters:

/<svcpt catalog>: Name of global catalog into which to create service endpoint.
<svcpt>: Service endpoint name.
/<svcpt_type catalog>: Name of global catalog in which service endpoint type resides.
<svcpt_type>: Service endpoint type name.
<.attr>: Attribute name to set (currently the only supported attribute is .description).
<property>: Property name to set.

Examples:

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

Create service endpoint 'CICS_PROD' using service endpoint type 'CICS_GW'

svcpt create /svcpt: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 'IMS_TEST' using service endpoint type 'IMS_GW'

svcpt.destroy

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

Syntax:

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

Parameters:

/<catalog>: Name of global catalog containing the service endpoint.
<svcpt>: Name of the service endpoint to be deleted.
--force: Skip the confirmation prompt.

Examples:

svcpt destroy /svcpt:MYDB2

Destroy service endpoint named MYDB2 in global catalog /svcpt

svcpt.list

List service endpoints.

Syntax:

svcpt list /<catalog> [ --batch ]

Parameters:

/<catalog>: Global catalog to search.
--batch: Display output in UDL format.

Examples:

None.

svcpt.lock

Lock a service endpoint.

Syntax:

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

Parameters:

/<catalog>: Name of catalog in which the service endpoint resides.
<svcpt>: Service endpoint 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 lock /svcpt:MYDB2

Lock service endpoint

svcpt lock /svcpt:MYDB2

Lock service endpoint 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.

svcpt.unlock

Unlock a service endpoint

Syntax:

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

Parameters:

/<catalog>: Name of catalog in which the service endpoint resides.
<svcpt>: Service endpoint 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 service endpoint.

Examples:

svcpt unlock /svcpt:MYDB2

Unlock service endpoint

svcpt unlock /svcpt:MYDB2 pwd=

Unlock service endpoint and prompt for password

svcpt unlock /svcpt:MYDB2 --override

Override the lock and unlock the service endpoint

Notes:

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