Open Application Program Interface › What is the Open Application Program Interface? › TUNCALL Syntax

TUNCALL Syntax

TUNCALL syntax is similar to z/OS utilities such as IDCAMS. The basic syntax for each TUNCALL statement is as follows:

serverid, verb keyword(operand1, operand2, operand3, ...) keyword(operand1, operand2, operand3,...) keyword keyword

The TUNCALL syntax is described next.

serverid

Name of the server that is locally running on the same system where TUNCALL is executing.

verb

Type of request.

MONITOR is the only supported verb.

MONITOR: Specifies how to manage monitor requests

You must put a comma between the serverid keyword and the verb keyword. The serverid and the verb keywords are positional and the serverid must be the first word followed by the verb with a comma between the two.

Spaces are supported.

additional keywords

After the verb, enter the keywords with the associated operands.

Each keyword must be separated by at least one space and the operands must be enclosed in parentheses. you must separate multiple operands with a comma.

Any number of spaces can be included with the comma.

In addition, character strings can be specified by enclosing the string with either single (') or double quotation marks ("); however, the quotation marks must be paired. The string does not need to be quoted if it contains only alphanumeric characters. In the latter case, the string is translated automatically to uppercase characters as well.

If you provide commands to TUNCALL with the TUNIN DD-statement, the commands can be continued to the next statement with a dash (-) as the last character on the line.

Blank lines are ignored, and comment lines can begin with an asterisk (*) or be embedded with paired slashes and asterisks (/*, */).

The following example is a valid monitor request:

//SMON JOB 1,'TUNCALL IT',MSGCLASS=A, CLASS=A
//*
//TUNCALL EXEC PGM=TUNCALL
//STEPLIB    DD DISP=SHR,DSN=CAMAT.V85.CEESPLD
//*
//TUNPRINT DD SYSOUT=*
//TUNIN DD *
 * This is a comment line
 /* This is another comment */
CA MAT, -
 MONITOR -
 INVOKE -
 JOBNAME(PROD01)   /* Another comment */