CA Top Secret distributes TSSCMMND in the CAKOSRC0 library. TSSCMMND is an assembler example of how to issue CA Top Secret commands embedded in other code. This member includes the TXPL DSECT. What additional information can be provided about the fields in the TXPL DSECT?
Here is what is provided for the TSSCMMND sample source:
We provide the TXPL parameter list and the required information necessary to use it while not documenting all fields because it is mostly an internal-only parameter list which contains a lot of proprietary information.
The programming interface supplied and documented is:
TXPLACEE ACEE address for administrator
TXPLCLEN Command Length
TXPLCBUF Command Buffer
Upon return CA Top Secret populates:
TXPLRET Command Response Area
TXPLRET contains one or more messages
Messages begin at TXPLRET+x'10' in the following format:
HW machine length, message text (machine length does not include the HW length field itself)
if more than one message is returned:
HW machlen,MSG same as previous. 0000 = end of buffer
If more than one message buffer is returned, it is pointed to by TXPLNXTR.
The TXPL does not contain a return code field. Any messages returned should have as the only or last message:
TSS0300I ffffffff FUNCTION SUCCESSFUL
-- OR --
TSS0301I ffffffff FUNCTION FAILED, RETURN CODE = nn
All returned messages should be as one would expect to see had the command been entered in TSO.