Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Description:  The EXEC CICS FETCH ANY command is used by a parent task to inquire on the
status of any child task, and returns the status of any completed child task which
has not yet been fetched.

Properties:

NameTypeMaximum LengthInput/Output
abcodestring4Output
anystring16Output
channelstring16Output
compstatusCVDA
Output
nosuspendBoolean
Input
timeoutnumeric
Input

Corresponding CICS Command Level API command: EXEC CICS FETCH ANY

...

Description:  The EXEC CICS FETCH CHILD command is used by a parent task to inquire on the
status of a specific child task, and returns the status of the specified child task.

Properties:

NameTypeMaximum LengthInput/Output
abcodestring4Output
channelstring16Output
childstring16Input
compstatusCVDA
Output
nosuspendBoolean
Input
timeoutnumeric
Input

Corresponding CICS Command Level API command: EXEC CICS FETCH CHILD

...

Code Block
languagejs
var cics = new Cics();
var runTransid = new Object();
var fetchAny = new Object();
var fetchChild = new Object();		
var freeChild = new Object(); 
var common = require('common', 'hbutils');
var debugging = require('debugging', 'hbutils');
/*
 * Set up input
 */
var runTransid =
    { channel : 'RUNTRANSIDTEST01',
      transid : 'HBNL'      
    }    
/*
 * Run a transaction
 */
try
{
    cics.exec.runTransid ( runTransid ) ;
}
 
catch ( e )  // the following will display any return codes that are returned from the call, which equate to the RESP and RESP2 values returned from the request
{
    writeln(debugging.object(e, 'Error Object'));
}
/*
 * Iterate over all of the properties
 */
for (var prop in runTransid) {
    writeln('\t', prop, ' = ', runTransid[prop]);
}
/*
 * Set up input
 */
var fetchChild =
   { child : runTransid.token,   
     nosuspend : true      
   }
/*
 * Fetch child
 */
try
{
    cics.exec.fetchChild ( fetchChild ) ;
}
 
catch ( e )  // the following will display any return codes that are returned from the call, which equate to the RESP and RESP2 values returned from the request
{
    writeln(debugging.object(e, 'Error Object'));
}
/*
 * Iterate over all of the properties
 */
for (var prop in fetchChild) {
    writeln('\t', prop, ' = ', fetchChild[prop]);
}

...

freeChild()

Description:  The EXEC CICS FREE CHILD command frees a specified child token which has been
previously allocated by an EXEC CICS RUN TRANSID command. If a parent task no
longer requires the response of a child task, then using the FREE CHILD command
will free the resources associated with that child task when it completes, rather
than waiting for them to be fetched.

Properties:

NameTypeMaximum LengthInput/Output
childstring16Input

Corresponding CICS Command Level API command: EXEC CICS FREE CHILD

...

Description:  RUN TRANSID initiates a local child transaction that runs asynchronously with
the parent transaction.

Properties:

NameTypeMaximum LengthInput/Output
transidstring4Input
channelstring16Input
childstring16Output

Corresponding CICS Command Level API command: EXEC CICS RUN TRANSID

...