Synopsis

ULONG BCPL_ReadArgs(
         BSTR btemplate,
         BPTR bvec,
         ULONG upb,
         struct DosLibrary * DOSBase );

ULONG BCPL_Read(
         BSTR btemplate,
         BPTR bvec,
         ULONG upb,
         TAG tag, ... );

Function

Parse command-line arguments according to a BCPL template and
return their values in a caller-provided BCPL vector. String
results are copied into the unused portion of that vector and
represented by BCPL pointers.

Inputs

btemplate - BCPL string containing the ReadArgs() option template.
bvec      - BCPL pointer to writable vector storage. The vector is
            cleared before parsing and also holds converted strings.
upb       - Number of IPTR-sized units available in the vector.
DOSBase   - DOS library base supplied by the BCPL calling convention.

Result

Number of vector units occupied by the parsed arguments and their
converted strings, or zero if parsing, allocation or string storage
fails. On success IoErr() is cleared.

Notes

The function uses ReadArgs() for template parsing. BCPL string
results occupy additional vector storage, so the caller must
provide room beyond the argument slots.

See also

dos.library/ReadArgs() dos.library/FreeArgs()

Synopsis

ULONG Dos_BCPL_putpkt(
         BSTR bdospacket,
         struct DosLibrary * DOSBase );

Function

Send a DOS packet to the message port specified in the packet's
dp_Port field without waiting for a reply. The sending process's
pr_MsgPort becomes the reply destination.

Inputs

bdospacket - BCPL pointer to an initialized DosPacket. Its dp_Port
             identifies the destination, and dp_Link points to a
             valid message. The caller must be a process.
DOSBase    - DOS library base supplied by the BCPL calling convention.

Result

DOSTRUE after the packet has been submitted. This does not indicate
that the destination has processed it.

Notes

The function sets dp_Link->mn_Node.ln_Name to the packet address
and dp_Link->mn_Length to the message size before calling SendPkt().
SendPkt() replaces dp_Port with the sender's reply port.

See also

dos.library/SendPkt() dos.library/WaitPkt()