Added March 2009

xcall MIAMEX, MX_CHKPCNET, status, flags {,clisvr}

MX_CHKPCNET checks the network state of the local PC (for A-Shell/Windows) or the ATE client:

See the Tab(-10,x) Function Listing for an equivalent Print Tab command (AG_CHKPCNET).

status  (Num)  [out]

will return 1 if the PC is connected to the Internet, and 0 if it is not. -1 indicates that the function is not supported (not Windows, ATE not present, or ATE PC version too old), and -15 indicates that ATE did not respond.

Note that since older versions of A-Shell would not have this function supported, you may want to pre-set status to something like -99 so you don't confuse a non-updated status with a real one (or, use MX_GETVER to check the A-Shell version before calling the function).

Notes also for ATE: if A-Shell on the server is 1138.3 or higher, but the ATE PC is not, the function returns STATUS = -1.

flags  (Num)  [out]

returns flags which can be interpreted as following:

clisvr (String, 1)  [in]

may be set to "S" (for server), or "L" (for local, which is the same as server in this context); anything else is treated as meaning "client". The option only has significance in the ATSD environment where the possibility exists of performing the function relative to the ATSD server or the client. In all other cases, the parameter is ignored and the operation is performed relative to the client, or returns an empty string if an applicable client is not present.

History

2011 July, A-Shell 5.1.1226:  Add clisvr parameter.

2009 February, A-Shell 5.1.1139:  Routine added to A-Shell.