Some API commands are extended with new options or RESP2 values. Also, the usage of certain options on existing API commands has changed. Check the new descriptions to ensure that you are using these options in the best way.
ASSIGN
ERRORMSG(data-area) 
- Returns
the error message up to a maximum of 500 bytes that is currently referenced
in the transaction abend control block for the CICS task. Following
a failure of a DPL request, the message is that returned from the
remote system. For messages shorter than 500 bytes the message is
padded with nulls.
If no message is present, the 500 byte area contains nulls.
- ERRORMSGLEN(data-area)
- Returns
a halfword binary value representing the length of the message returned
for ERRORMSG. If the message referenced in the transaction abend control
block exceeds 500 bytes, the message is truncated and the length is
set to 500.
If no message is present the length returned is 0.
- LINKLEVEL(data-area)
- Returns
a halfword binary value representing the program link level in the
local system. The topmost link level is level one and for each EXEC
CICS LINK the link level is incremented by one. The link level is
not incremented for a language CALL statement. If a program is the
target of a DPL request, the link level returned is that within the
CICS region it is executing and not the wider distributed transaction.
If a program is DPLed to, then link level one will be the CICS mirror
program DFHMIRS.
- APPLICATION (data-area)
- Returns
the 64 character name of the current application
associated with the task. It is part of the application context that
is made up of the application name, the platform name, the operation
name and the major, minor and micro version number of the application.
If there is no application context associated with the task, then
blanks are returned.
- MAJORVERSION(data-area)
- Returns
the fullword binary value representing the major version of the current application associated with the task, which
is part of the application context. If there is no application context
associated with the task, then -1 is returned.
- MICROVERSION(data-area)
- Returns
the fullword binary value representing the micro version of the current application associated with the task, which
is part of the application context. If there is no application context
associated with the task, then -1 is returned.
- MINORVERSION(data-area)
- Returns
the fullword binary value representing the minor version of the current application associated with the task, which
is part of the application context. If there is no application context
associated with the task, then -1 is returned.
- OPERATION(data-area)
- Returns
the 64 character name of the current operation
associated with the task, which is part of the application context.
If there is no application context associated with the task, then
blanks are returned.
- PLATFORM(data-area)
- Returns
the 64 character name of the platform associated with the task, which
is part of the application context. If there is no application context
associated with the task, then blanks are returned.
For more information see ASSIGN.
DELAY
- MILLISECS(data-value)
- specifies a fullword binary value in the range 0–999, when
HOURS, MINUTES or SECONDS are also specified, or 0-359999999 when
MILLISECS is the only option specified.
For more information see DELAY.
FORMATTIME
- STRINGZONE(cvda)
- Specifies
the timezone in which the time stamp returned in DATESTRING is to
be returned. The CVDA values are as follows:
- UTC
- DATESTRING is to be returned in UTC. This value is the default setting.
- LOCAL
- DATESTRING is to be returned in LOCAL timezone.
For more information see FORMATTIME.
LINK
This command operates in the current application context.
If the command is issued by a program that is running under a task
for an application deployed on a platform, CICS® searches first for the named program in
the private program directory for the application. If the named program
is not found there, CICS then
searches the public program directory.
When
this command is used to link to a program that is declared as an application
entry point for an application deployed on a platform, the CICS bundle where the application
entry point is declared must have a status of AVAILABLE. The link
is made to the highest numbered version of the application that is
installed, enabled, and available. To link to a specified version
of an application deployed on a platform, use the INVOKE APPLICATION command instead
of the LINK command.
For more information see LINK.
