Start of change

FREE SERVICE command (DSN)

The FREE SERVICE (DSN) subcommand deletes an application package that represents a Db2 REST service. The command also removes the corresponding entry from the catalog tables.

The FREE SERVICE subcommand does not proceed until all currently running applications using the package finish running.

Environment

You can issue FREE SERVICE from a DSN session under TSO that runs in the foreground or background.

Data sharing scope: Group

Authorization

To execute this subcommand, you must use a privilege set of the process that includes one of the following privileges or authorities:
  • Ownership of the package
  • BINDAGENT privilege granted by the package owner
  • System DBADM authority
  • SYSCTRL authority
  • SYSADM authority
  • PACKADM authority on the collection or on all collections.

The BIND privilege on a package alone is not sufficient authorization to free a service package.

Syntax

Read syntax diagramSkip visual syntax diagram FREE SERVICE (location-name. collection-id. service-name.(version-id))

Option descriptions

Start of changelocation-nameEnd of change
Start of changeSpecifies the location of the DBMS where the service is to be freed. The location name must be defined in the SYSIBM.LOCATIONS table. If this table does not exist or the DBMS is not found, you receive an error message. If the location name is specified, the name of the local Db2 subsystem must be defined. If you omit location-name, the default is the local Db2 subsystem.End of change
collection-id
Identifies the collection of the REST service. There is no default. The collection-id can be an undelimited or a delimited identifier. The delimiter for collection-id is double quotation marks ("). If collection-id is delimited, Db2 does not convert the value to uppercase.
service-name
Identifies the REST service. There is no default. The service-name can be an undelimited or a delimited identifier. The delimiter for service-name is double quotation marks ("). If service-name is delimited, Db2 does not convert the value to uppercase.
version-id

Identifies the version of the REST service.

If you specify () for version-id, or if you omit the version-id , the default version of the REST service is deleted.

Usage notes

Trace information for data sharing members
When this command with group scope is issued in a Db2 data sharing member, it also runs on all other active members. IFICID 090 trace records for other group members can show that the same command was issued by the SYSOPR authorization ID from the 016.TLPKN5F correlation ID, in addition to the trace records from the member where the original command was issued. See Command scope in Db2 data sharing.
End of change