November 1998 Troubleshooting Professional Magazine

Reprinted by permission of author. Material provided as-is, use at your own risk.

Example Page Description Language for webdiag.pl


 
COMMON
  COPYRIGHT Marc-Henri Poget
  ROOT      troubleshoot_demo
  NEW       demo000.htm         New Troubleshoot 
  TITLE     NTIS Troubleshooting Support
  FNAME     demo
  HELP      help.htm#DEPANNAGE  Help 
  DATE      98.08.04
  TRUE      YES
  FALSE     NO
  QUESTION  Question
  POSSIBLE  Possible Solution
  FONTFACE  ARIAL
END

##################################################

NODE troubleshoot_demo
    SWITCH Is your question or problem related to
        NEXT fax2fax    Fax-to-Fax ?
        NEXT web_fax    WebFax ?
        NEXT email_fax  EFax ?
        NEXT vprint     Virtual Print ?
        NEXT fax_adm    FaxNet management ?
        NEXT print_prn  Output a Windows file to .PRN format ?
        NEXT vam        Virtual Answering Machine ?
        URL http://www.ntis.com.tw  more information about NTIS products.
    END
END

NODE fax2fax
    IF Is it possible to send a fax from your fax machine ?
        NEXT check_from_web
        NEXT check_dial_box
    END
END

NODE check_from_web
    TEXT
        Connect to the FaxNet Web page and go to the FaxNet billing 
        section.
    END
    IF Your transaction appears in the list and the fax has been sent ?
        NEXT end_troubleshoot
        NEXT check_fax_net
    END
END

NODE web_fax
    SWITCH The WebFax problem is
        NEXT cant_attach      it is not possible to attach a file using WebFax.
        NEXT check_fax_net    after sending, I don't get a confirmation Web page.
        NEXT contact_fax_net  I get a confirmation page, but the fax isn't sent.
    END
END

NODE cant_attach
    SOLUTION
        <P>
        If you are using Microsoft Internet Explorer, the "attach file" feature 
        is not available.</P>
        <P>
        If you are using Netscape Navigator, make sure you have the version 
        v2.1 or above.</P>
    END
END

NODE email_fax
    IF After sending, do you get a confirmation mail and the fax has not been sent ?
        NEXT check_fax_net
        NEXT no_conf_mail
    END
END

NODE no_conf_mail
    TEXT
        Make sure that you attached EFAX.TXT with your account 
        number and password.
    END
    IF After checking EFAX.TXT, can you send a fax ?
        NEXT check_fax_net
        NEXT contact_fax_net
    END
END

NODE vprint
    SWITCH The question or problem is
        NEXT word_table      Word tables are not well printed.
        NEXT check_fax_net   I get the Transaction window and it displays information about my fax, but the fax isn't printed.
        NEXT vprint_nt       I want to install Virtual Print on Windows NT.
        NEXT contact_vprint  none of the two mentionned above.
    END
END

NODE vprint_nt
    SOLUTION
        Sorry, the current version of Virtual Print doesn't support 
        Windows NT. Wait for the next release of Virtual Print.
    END
END

NODE word_table
    SOLUTION
        This is normal. All Internet services encounter problems when trying 
        to print Word documents containing tables.
    END
END

NODE fax_adm
    SWITCH The question or problem is
        NEXT chinese_english   how to setup the language of FaxNet management tools ?
        NEXT contact_fax_adm   another problem.
    END
END

NODE chinese_english
    SOLUTION
        <P>
        Open the <B>faxop.ini</B> in your FaxNet directory on your PC.</P>
        <P>
        Change the key word "english" to "chinese" and restart your software.</P>
        <P>You don't need to re-install the FaxNet management applications.</P>
    END
END

NODE print_prn
    SOLUTION
        To output a file to .PRN, follow these steps:
        <UL>
        <LI>Install a printer driver which supports PostScript, like for instance <B>HP LaserJet 4/4M Plus PS</B>.
        <LI>From any Windows application, when printing, select the PostScript driver and choose "output to a file".
        <LI>Enter the path and filename of the output file, making sure that the extension is .PRN.
        </UL>
    END
END

NODE check_fax_net
    TEXT
        Just after sending your fax, log on the server where you are registered.
        Check the file <B>/var/spool/fax/etc/xferlog</B>.
    END
    SWITCH Do you see
        NEXT recv_send          a RECV record and a SEND record ?
        NEXT recv               only a RECV record ?
        NEXT no_recv_no_send    neither a RECV nor a SEND record ?
    END
END

NODE recv_send
    TEXT
        <P>
        Wait a little, maybe the server is still busy processing some
        other faxes.</P>
        <P>
        Log on the server which will send the fax to the destination using the 
        phone network, then check the status of its ports using 
        <B>/usr/local/bin/faxstat</B>.
    END
    IF Are all the ports busy ?
        NEXT term_port_busy
        NEXT term_port_avail
    END
    IF Does any port have an error ?
        NEXT port_error
        NEXT end_troubleshoot
    END
END

NODE port_error
    TEXT
        Try to restart the fax server processes.
    END
    IF After restarting the fax server, does the port still have the error ?
        NEXT contact_fax_net
        NEXT end_troubleshoot
    END
END

NODE term_port_busy
    TEXT
        Log on the server which will send the fax to the destination using the 
        phone network, then check the <B>/var/spool/fax/etc/xferlog</B> file.
    END
    IF Is there a RECV record corresponding to your fax ?
        NEXT term_recv
        NEXT term_no_recv
    END
END

NODE term_recv
    SOLUTION
        Wait a little, all the ports are busy, your fax will be processed soon.
    END
    IF After few minutes, has your fax been processed ?
        NEXT end_troubleshoot
        NEXT contact_fax_net
    END
END

NODE term_no_recv
    SOLUTION
        Check the fax routing table in the server where you sent the fax and 
        that the destination server is reachable (using the ping command).
        NEXT contact_fax_net It's still not working.
    END
    
END

NODE term_port_avail
    TEXT
        Examine the output of <B>/usr/local/bin/faxstat</B> more carefully.
        Watch for the pending jobs.
    END
    IF Is your job pending ?
        NEXT term_recv
        NEXT contact_fax_net
    END
END

NODE recv
    SOLUTION
       Maybe the server is very busy, wait a little.
    END
    IF After waiting, is there a SEND record in <B>/var/spool/fax/etc/xferlog</B> ?
        NEXT wait_recv
        NEXT no_recv_no_send
    END
END

NODE wait_recv
    IF After waiting, is there a SEND record in <B>/var/spool/fax/etc/xferlog</B> ?
        NEXT recv_send
        NEXT contact_fax_net
    END
END

NODE no_recv_no_send
    SOLUTION
        Check that the fax servers are running.
        NEXT contact_fax_net The fax servers are running and the faxes cannot be sent.
    END
END

NODE check_dial_box
    TEXT
        Please check that the following numbers have been setup in your dial box:
        <UL>
        <LI>your account number,
        <LI>your password,
        <LI>the fax number of the FaxNet server where you are registered.
        </UL>
    END
    IF After having checked your dial box, can you send a fax from your fax machine ?
        NEXT end_troubleshoot
        NEXT check_fax_net
    END
END

NODE vam
    SOLUTION
        For all Virtual Answering Machine related problems, please contact:
        URL mailto:susin@mail.ntis.com.tw       Susin
    END
END

NODE end_troubleshoot
    TEXT
        Congratulations, you have been able to solve your problem by yourself !
    END
END

NODE contact_fax_net
    SOLUTION
        Please contact:
        URL mailto:hung@mail.ntis.com.tw  Hung Hua-Hung
    END
END

NODE contact_vprint
    SOLUTION
        Please contact:
        URL mailto:beatrice@mail.ntis.com.tw  Beatrice Huang
    END
END

NODE contact_fax_adm
    SOLUTION
        Please contact:
        URL mailto:sue@mail.ntis.com.tw  Sue Tarn
    END
END

 

[ Back to this month's Troubleshooting Professional Magazine ]