xcall LOG, logstr {,qflag {,status}}

xcall LOG, dev$, p$, pn$

LOG.SBR allows you to log to a new disk and PPN, using an ersatz or traditional specification, with an option to silence the normal output (start message) that you would otherwise see with an AMOS LOG command. It may also be used to return your current device, project, and programmer number.

This routine was modified, in build 1159 of 24 September 2009, to support returning data into dynamic variables, such that they expand as needed. Previously, the output data was being truncated to the current size of the variable, or 0 for uninitialized.

xcall LOG,"SYS:"               (log to SYS:)

xcall LOG,"LOG DSK0:[1,4])     ('LOG' is optional)

xcall LOG,"SYS:","Q"           (silence output)

xcall LOG,DEV$,P$,PN$          (return current login)

If the status parameter (floating point type) is specified and is non-zero, the routine attempts to check if the operation succeeded and returns a zero for success or the system errno for an error. Whether or not status is specified, LOG always checks to see if the destination device is defined. However, without status, it does not check if a PPN within a device actually exists and is accessible. This it could be possible to appear to log to non-existent ppns.