1 Summary of NETSERV Commands: ---------------------------- Commands for General Users: --------------------------- Get filename filetype < prologtext > Obtain a file from NETSERV. GETND Same as GET but requests file in Netdata fmt. GETDD Same as GET but requests file in DiskDump fmt GETPP Same as GET but requests Punch or Print fmt. GETLP Same as GET but requests LISTSERV-Punch fmt. GET80 Same as GET but split records, use Punch fmt. GET NODENTRY nodeid Retrieve node entry from NODES file. SENDme filename filetype Same as GET (for compatibility with NICSERVE) HELP < helptype > Obtain short helpfile or specific help-info. Query CMD List of available NETSERV commands. Query Controller Userid@Nodeid of this Netserv's controller Query File filename filetype Display information about file. Query Service < nodeid > Tells you for which countries/subnets this Netserv provides service and which Netserv is responsible for your node or for "nodeid". SERVE subjuser Return NETSERV services to a "disabled" user UDS (User Directory Services commands) UDS ADD ( + UDS entry ) Add user's entry to the User Directory. UDS REP ( + UDS entry ) Replace user's entry. UDS DEL Delete user's entry from the User Directory. Note: UDS ADD/REP/DEL commands must be sent to YOUR country Netserv. UDS FIND < searchlimit > search-arguments Find entries, 1 line/entry. UDS GET < searchlimit > search-arguments Get complete entries. Note: UDS FIND/GET commands may be sent to ANY country Netserv. Commands for Privileged Users: ------------------------------ Privileged users are users who have got a NETSERV password assigned either by their node administrator or by the EARN coordinator. AFD ( Automatic File Distribution commands ) AFD ADD password filename filetype < prologtext> AFD DEL password filename filetype AFD Query AFD REP password filename filetype < prologtext> AFD UPDLIST password SUBSCRIBE (same as AFD ADD) UNSUBSCRIBE (same as AFD DEL) 1 Commands for Privileged Users: (continued) ------------------------------ FUI ( File Update Information commands ) FUI ADD password filename filetype Add an entry into your FUI-list. FUI DEL password filename filetype Delete FUI-list entry. FUI Query Display your FUI-list entries. FUI REP password filename filetype Refresh FUI-list entry. FUI UPDLIST password Execute a list of updates. INFORM password filename filetype (same as FUI ADD) UNINFORM password filename filetype (same as FUI DEL) | PUT password filename filetype < date time > Put a file on NETSERV disks. PW CHange password newpw Change password. STAT ( Request statistics commands (for file owners)) STAT ADD password filename filetype Subscribe to weekly file stat. STAT DEL password filename filetype Unsubscribe. STAT GET filename filetype Request immediate statistics STAT Query Display your STAT subscription. Commands for Node Administrators: --------------------------------- Node administrators are people defined as contact person for a node. AFD ADD password filename filetype FOR subjuser ... ... < prologtext> AFD DEL password filename filetype FOR subjuser AFD Query password subjuser AFD REP password filename filetype FOR subjuser ... ... < prologtext> AFD UPDLIST password < NONOTIFY > FUI ADD password filename filetype FOR subjuser FUI DEL password filename filetype FOR subjuser FUI Query password subjuser FUI REP password filename filetype FOR subjuser FUI UPDLIST password < NONOTIFY > PUT NODENTRY password Return updated node entry Note: PUT NODENTRY is only allowed at your country Netserv. PW ADD password subjuser newpw Define privileged user and passwd PW DEL password subjuser Delete privileged user and passwd PW Query password subjuser Display password(s) of user(s). Note: PW commands may be sent to country Netserv or to sub-Netserv for the specified node. UDS UPDLIST password < NONOTIFY > Submit a list of ADD, REP and DEL requests to User Directory Services Note: UDS UPDLIST is only allowed at your country Netserv. 1 Description of Parameters: -------------------------- filename 1st part of a 2 part file identifier (see filelists) filetype 2nd part of a 2 part file identifier (see filelists) | date the date to be assigned to a file. Format: YY/MM/DD | time the time to be assigned to a file. Format: HH:MM:SS helptype specify: command or message nbr. newpw new password to be assigned by a PW ADD or CHANGE request nodeid the identifier of a node password is the current password of a privileged user prologtext will be returned as 1st record of file search_arguments fieldnames and values that are to be searched in UDS searchlimit max. number of entries to be returned on UDS GET or FIND subjuser "userid@nodeid" of a user who is subject in a request The complete help description can be obtained by sending the command: GET NETSERV HELPFILE to NETSERV. Next page explains how to send requests to Netserv. A list of available files can be found in NETSERV FILELIST which is the main filelist (try: GET NETSERV FILELIST ). NETSERV FILELIST points to other filelists which may also be of interest to you. Among them is the PROGRAMS FILELIST for programs and execs. 1 How to send requests to NETSERV: -------------------------------- NETSERV commands may be sent either: 1) as an immediate message or 2) as the first record of a file. If data is to be sent with a command (e.g. PUT and some UDS commands) the command line must be the first record of the file containing the data. Examples for VM users: a) use the NETSRV EXEC (available from Netserv (PROGRAMS FILELIST)) (this is the most recommendable way). b) TELL NETSERV at BITNIC cmdline c) SENDFILE prepared file A NETSERV at DEARN and the prepared file might look as follows: PUT password filename filetype --- dataline 1 --- --- dataline 2 --- --- dataline 3 --- etc. Examples for MVS users (with TRANSMIT command): a) Transmitting the command as a message: Enter: TRANSMIT DEARN.NETSERV NOPROLOG When the screen for message text appears enter the NETSERV command as the 1st line and hit PF3 to submit the message. b) Transmitting the command in a file: Prepare a dataset with the NETSERV command line as the 1st record, e.g.: PUT password filename filetype --- dataline 1 --- --- dataline 2 --- --- dataline 3 --- etc. Enter: TRANSMIT DEARN.NETSERV DATASET(dsname) The dataset must not be a partitioned dataset since NETSERV cannot receive this type of dataset. If it is a member of a partitioned dataset use the 'SEQUENTIAL' parameter: TRANSMIT DEARN.NETSERV DATASET(dsname(member)) SEQUENTIAL Which Netserv to use? --------------------- If you send the QUERY SERVICE command to any Netserv it will tell you to which Netserv you should send your requests for general services and for extended serices (country server). It is best to follow these suggestions in order to avoid unnecessary network traffic. The QUERY SERVICE response does also mention a country/subnet code. This is the code which should be specified in certain user interface procedures when you are asked for your country/subnet. It allows the procedure to select the right Netserv for sending your request.