OSLCOPTS

Purpose

Use this statement to configure the integration with products that provide you with an OSLC interface to create and manage tickets, for example IBM SmartCloud Control Desk.

Format


1  OSLCOPTS  PASSWORD (  pwd )?  POLICY (
2.1! ALL
2.1 MONITORED
2.1 CRITICAL
1 )?  PRIORITY (
2.1! 3
2.1 n
1 )?  TDWCURI (  basic url )?  TKTDESC (  string )  TKTURI (  uri )  USER (  userid )?  USERFLD (
2.1! NO
2.1 YES
1 )

Parameters

PASSWORD (pwd)
The password associated with the user set in USER, it can be up to 31 characters. The password is stored in plaintext, meaning that it is not encrypted. To encrypt it, run the sample EQQBENCO JCL provided in the EQQSAMP library. For details about how to encrypt the password, see Managing the Workload.
This parameter is required and does not have a default value.
POLICY(ALL|MONITORED|CRITICAL)
The policy applied to open tickets for jobs that ended in error. The default value is ALL, meaning that a ticket is opened for any job that ends in error. Set this parameter to MONITORED to open tickets only for the jobs that have the monitored flag; set it to CRITICAL to open tickets only for critical jobs or jobs that belong to a critical network.
PRIORITY (n|3)
The priority assigned to the tickets that will be opened for jobs that ended in error. Valid values are from 1 (highest) to 5 (lowest), the default is 3.
TDWCURI(basic url)
The basic URL to launch the Dynamic Workload Console in context, allowing you to view the job in error and take the appropriate action. This parameter is required if you want to use the &TWDCLINK variable in the string set for TKTDESC.
For example, a basic URL might be:
https://mypc:29443/console/xLaunch.do?pageID=
tws.WebUI.External.navigation&showNavArea=false
&action=BrowseJobs&hostname=webuidev&port=31217&server=C851
For detailed information about how to create a basic URL for the Dynamic Workload Console, see the Administration Guide.
TKTDESC('string')
A detailed description for the ticket, included between single quotation marks. This parameter is valid only if you selected the DESCRIPTION-LONGDESCRIPTION check box in the SmartCloud Control Desk (for detailed information about how to set this check box, see Managing the Workload).
You can use the following variables:
  • &APPLIA
  • &APPLNAME
  • &ERRCODE
  • &JOBNUM
  • &OPERNUM
  • &OPTEXT
  • &SSNAME
  • &TWDCLINK (provided that you set the TDWCURI parameter)
  • &TWSJOBN
  • &WSNAME
You can also use user field operation info, provided that you set USERFLD(YES). This parameter is optional.
For example, you might set TKTDESC as follows:
TKTDESC('Ticket opened for &APPLNAME &OPERNUM &APPLIA job &TWSJOBN &JOBNUM 
ended in error with error code &ERRCODE. Follow the instructions &USRFLD1.
Then use launch in context &TDWCLINK')
TKTURI(uri)
The URI provided by the product that manages the tickets and provides that OSLC interface. This parameter is required.
USER (userid)
The user ID to open the ticket. Ensure that you specify a user authorized to create and manage tickets on the OSLC interface.

This parameter is case-sensitive and can be up to 47 characters. It is required and does not have a default value.

USERFLD(YES|NO)
Specify YES to allow user field operation info in the TKTDESC parameter. The default value is NO.