Need Information About CA Top Secret TXPL Fields In TSSCMMND

Products

• Top Secret
• Top Secret - LDAP

Issue/Introduction

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?

Environment

Release:
Component: TSSMVS

Resolution

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: 

TXPLID Eyecatcher 
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.