The TPU$PARSEINFO routine parses a command and builds the item
list for TPU$INITIALIZE.
Format
TPU$PARSEINFO fileio ,call_user
1 – Returns
OpenVMS usage:item_list
type: longword (unsigned)
access: read only
mechanism: by reference
The routine returns the address of an item list.
2 – Arguments
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 for 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 for a
descriptor of a call-user routine.
3 – Description
The TPU$PARSEINFO routine parses a command and builds the item
list for TPU$INITIALIZE.
This routine uses the command language (CLI) routines to
parse the current command. It makes queries about the command
parameters and qualifiers that TPU expects. The results of
these queries are used to set up the proper information in an
item list. The addresses of the user routines are used for those
items in the list. The address of this list is the return value
of the routine.
If your application parses information that is not related to the
operation of TPU, make sure the application obtains and uses
all non-TPU parse information before the application calls the
TPU$PARSEINFO interface. This is because TPU$PARSEINFO destroys
all parse information obtained and stored before TPU$PARSEINFO
was called.