The TPU$CLIPARSE routine parses a command line and builds the item list for TPU$INITIALIZE. Format TPU$CLIPARSE string ,fileio ,call_user
1 – Returns
OpenVMS usage:item_list type: longword (unsigned) access: read only mechanism: by reference This routine returns the address of an item list.
2 – Arguments
string OpenVMS usage:char_string type: character string access: read only mechanism: by descriptor Command line. The string argument is the address of a descriptor of a DECTPU command. fileio OpenVMS usage:vector_longword_unsigned type: bound procedure value access: read only mechanism: by descriptor File I/O routine. The fileio argument is the address of a descriptor of a file I/O routine. call_user OpenVMS usage:vector_longword_unsigned type: bound procedure value access: read only mechanism: by descriptor Call-user routine. The call_user argument is the address of a descriptor of a call-user routine.
3 – Description
This routine calls CLI$DCL_PARSE to establish a command table and a command to parse. It then calls TPU$PARSEINFO to build an item list for TPU$INITIALIZE. If your application parses information that is not related to the operation of DECTPU, make sure the application obtains and uses all non-DECTPU parse information before the application calls TPU$CLIPARSE. You must do this because TPU$CLIPARSE destroys all parse information obtained and stored before TPU$CLIPARSE was called.