NS3000/iX Operations and Maintenance Reference Manual (36922-90039)

ManualsBrandsHP ManualsSoftwareMPE/iX 6.0 Operating System

101

102

103

104

105

106

107

108

109

110

Chapter 6 103

Using NETTOOL

Adding Your Own Tools

You can add you own diagnostic tools to by following some simple rules.

You can also provide help information on the user-provided tools.

To Add User Tools

Information needed to run a user-provided tool must reside in

USERINFO.NET.SYS. You can create this ﬁle with any text editor. It

must have a record length of 80 characters or less.

You can describe up to 20 user tools in the ﬁle. For each tool, two types

of entries are needed: the one word command which will initiate the

tool from the root level of NETTOOL, and a list of the MPE commands

required to start the tool (as if it were being used standalone).

The ﬁrst character in the tool command must be alphabetic. The

command can be up to 20 characters in length. It must not duplicate

any NETTOOL global command, core tool name, or associated tool name.

The ﬁrst character in a line containing an MPE command must be an

exclamation mark. Characters may be either lower or upper case, but

NETTOOL does not distinguish between the two. NETTOOL does not

interpret the string after the exclamation mark in any way. Up to 79

characters may follow the exclamation mark.

The list of MPE commands must follow the command name. For

example, a valid set of entries in the ﬁle might be:

NEATPROG2

!file input=fromhere.pub.sys

!file output=tohere.net.sys

!run myprog.maui.hawaii;info="map, 26, verbose";lib=p

TESTTOOL

!run testtool.net.sys

To run MYPROG.MAUI.HAWAII from the NETTOOL root, a user would

enter the command NEATPROG2. To run TESTTOOL.NET.SYS, the user

would enter TESTTOOL.

Any ﬁrst character in a line other than !, a..z,orA..Z is an error and

will cause all subsequent entries to be ignored. Also, if you specify more

than ﬁve MPE commands for a tool, all subsequent entries in the ﬁle

will be ignored. Blank lines have no effect. Lines with only a ! will be

sent to MPE as a carriage return.

A sample USERINFO ﬁle is included as part of the NETTOOL package.