PMDF popstore & MessageStore Manager's Guide
Previous Next Contents Index

5.2.1.4 show_user command: show information about the user's account

The show_user command is used to display information about a given user. The parameter names and associated values accepted by the command are listed in Table 5-4.

This command must be presented to the user information CGI via the URL 


http://host:7633/msps_user/

Table 5-4 show_user Command Parameters
parameter=value   Description
mformat=file-spec Optional (popstore only) Name of the formatting file to use to format each message reference in the account's list of stored messages. The recognized substitution strings for this formatting file are listed in Tables 4-10 and 4-24.
on_error=file-spec Required Name of the formatting file to use to format the results when the command fails.
on_success=file-spec Required Name of the formatting file to use to format the results when the command succeeds.
pformat=file-spec Required Name of the formatting file to use to format each account listing. The recognized substitution strings for this formatting file are listed in Table 4-10 and 4-15.

An example command is shown below: 


command=show_user&pformat=susr.txt&mformat=smsg.txt 
  on_success=susr_success.txt&on_error=susr_error.txt
Sample formatting files are shown in Example 5-2 and Example 5-3. These are the formatting files used by the interactive command line management utility.

Example 5-2 show_user Account Formatting File 

 
Username:           %username 
Owner:              %owner 
Group:              %group_name 
Store Type:         %store 
Usage flags:        %flags 
Site-defined:       %private 
 
Last pwd change:    %last_pwd_change 
Last connect:       %last_connect 
Last disconnect:    %last_disconnect 
Total connect time: %total_connect_dhms 
Total connections:  %total_connections 
Past block days:    %past_block_days 
Last billing:       %last_billing 
 
Message count:      %message_count{%10u} (popstore only) 
Quota used:         %quota_used_k{%10.2f} Kbyte%s 
Primary quota:      %quota_k{%10.2f} Kbyte%s 
Overdraft quota:    %overdraft_k{%10.2f} Kbyte%s

Example 5-3 show_user Message List Formatting File (popstore only) 

%none{User has no stored messages} 
%msgr_id{%4u}. Filename: %msgr_filename 
      Received: %msgr_created 
      Size:     %msgr_size_k K 
      Flags:    %msgr_flags

5.2.2 Header trimming of displayed messages

Header trimming is applied to the displayed message's header when the part parameter is supplied to the show command. The user CGI uses a default header trimming option file, popstore_cgi_headers.opt, file located in the PMDF table directory. To use different options, create a new header trimming option file named popstore_site_cgi_headers.opt. Place that file in the PMDF_table directory. (On UNIX systems, ensure that the file is owned by the PMDF account.) When that file is detected, it will be used instead of the Process Software-supplied file. The Process Software-supplied file will be ignored and only those options specified in the site-supplied file used.

See the PMDF System Manager's Guide for information on the use and format of header trimming option files.

Previous Next Contents Index