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
Option descriptions
- location-name
- Specifies 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.
- 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.