Sub - Agilent Technologies 3458A User Manual

SUB

SUB
Syntax
Remarks
246 Chapter 6 Command Reference
Subprogram. Stores a series of commands as a subprogram and assigns the
sub-program name.
SUB name
name
Subprogram name. A subprogram name may contain up to 10 characters. The
name can be alpha, alphanumeric, or an integer from 0 to 127. When using an
alphanumeric name, the first character must be alpha. Alpha or alphanumeric
subprogram names must not be the same as multimeter commands or parameters
or the name of a stored state. The characters _ and ? can also be included in an
alpha or alphanumeric name.
When using an integer subprogram name (0 - 127), the multimeter assigns the
prefix SUB to the integer when the subprogram is stored. This differentiates an
integer subprogram name from an integer state name. For example, a sub-program
stored with the name 15 will be recorded as SUB15. The subprogram can be
accessed later using either the name 15 or SUB15. A subprogram named 0 (zero)
is designated the autostart subprogram (see 7th Remark following).
Power-on name = none.
Default name = none; parameter required.
•
Subprogram entry is terminated by the SUBEND command. The CALL
command is used to execute a subprogram, and the PAUSE and CONT
commands suspend and resume subprogram execution, respectively.
•
When you store a new subprogram using the name of an existing subprogram,
the new subprogram overwrites (replaces) the old subprogram.
•
Entering (storing) a subprogram from the front panel is not recommended since
front panel utilities (e.g., up and down arrows) can inadvertently be stored in
the subprogram. Once you have executed the SUB command from the front
panel, the display shows SUB ENTRY MODE until the SUBEND command
is executed or the RESET key is pressed. The SUBEND command does not
appear in the front panel menu unless you are storing a subprogram.
•
If a SCRATCH, DELSUB, a second SUB command, or the GPIB Device Clear
command occurs in a subprogram, the multimeter does not store the command
but does store the rest of the subprogram. Subprogram execution will be aborted
if the RESET command is encountered (do not store RESET in a subprogram).
•
You can not store a subprogram with less than 800 bytes of subprogram/state
memory remaining.
•
Subprogram execution will be aborted if an error is detected or the GPIB Device
Clear command is received. The GPIB Device Clear command will also abort
the process of storing a subprogram.