The functions below can help you perform selected system tasks from your browser for your NetLink site (to perform other functions you must have direct access to your server):
Click on the link above to test the following functions:
This helps ensures that the settings and file/directory permissions are correct from the perspective of the web server software.
The "syssetup" is a special command word that NLNETUPD recognizes and is not an existing Request Type. When it receives this command word the NLNETUPD program runs the same test function you can run from NL-01-01, but it returns the results as an HTML browser page.
Tip: If you can run this test function without error from NL-01-01 but get errors when running it from a browser, one likely cause is permission errors. When you are logged on to SouthWare you are recognized as a particular user by the operating system. When you execute NLNETUPD from a browser you are recognized as a different user (this varies depending on the web server). Make sure that the user your web server software uses has proper permissions for the directories that NetLink uses.
You may execute the following request IDs to display NetLink error files to your browser. These are similar to the SYSSETUP request command in that there is not an actual request type in the NL-01-02 file for these names. These are system reserved names that NetLink recognizes:SYSBLIC - This displays the current contents of the ALNLBLIC.SEQ file to your browser. This shows any license-related errors.
SYSBLOG - This displays the current contents of the ALNLBLOG.SEQ file to your browser. This shows any invalid login attempts.
SYSERR - This displays the current contents of the ALNLERR.SEQ file to your browser. This shows errors that caused a NetLink request to fail.
You may send any of the following request IDs to NetLink to control the Audit Mode features. This helps you remotely debug a problem with a request or a system set up problem without having direct access to the server. These are similar to the SYSSETUP request command in that there is not an actual request type in the NL-01-02 file for these names. These are system reserved names that NetLink recognizes:
AUDITON - This sets the AUDIT_MODE=ON parameter in the ALNLCFG.SEQ file.
AUDITOFF - This sets the AUDIT_MODE=OFF parameter in the ALNLCFG.SEQ file.
AUDITSHORT - This sets the AUDIT_MODE=SHORT parameter in the ALNLCFG.SEQ file (SHORT is an abbreviated version of audit mode without the variable table).
AUDITDISPLAY - This displays the current contents of the ALNLCFG.SEQ file to your browser.
AUDITCLEAR - This clears the contents of the ALNLCFG.SEQ file below the CO_ID, AUDIT_MODE, and SCAFFOLD_MODE lines. This is helpful to clear the existing audit information before you run a request in Audit Mode.
CLEARTERM - This clears all NL login sessions. Automatically processes the SWLOGOFF function for all seats reserved for internal NetLink (Z?? and Q?? line #'s). In order for users to continue to process via NetLink, they must log back in.
In the NetLink control record (NL-01-01, field 9 Other Security, Remote SysAdmin Password) you may define a password that is required for browser access to the special system administration function requests including this page:
If you enter a non-blank password in this field you must send the password as part of the request for these functions using the format "P=password". For example, if your password is "ABC321" you could turn on Audit Mode with the request:
We recommend that you implement this password feature at existing sites as additional protection.