--- loncom/homework/structuretags.pm	2001/08/17 14:24:29	1.55
+++ loncom/homework/structuretags.pm	2001/08/18 16:08:34	1.58
@@ -2,7 +2,7 @@
 # definition of tags that give a structure to a document
 # 2/19 Guy
 # 6/26/2001 fixed extra web display at end of <web></web> tags
-# 8/17 Gerd Kortemeyer
+# 8/17,8/18 Gerd Kortemeyer
 
 package Apache::structuretags; 
 
@@ -82,6 +82,7 @@ sub start_problem {
       &Apache::lonxml::debug("Using default type, problem, :$uri:");
     }
   }
+
 #adeed vars to the scripting enviroment
   my $expression='$external::part='.$Apache::inputtags::part.';';
   &Apache::run::run($expression,$safeeval);
@@ -92,6 +93,34 @@ sub start_problem {
   my ($result,$head_tag_start,$body_tag_start)=
     &page_start($target,$token,$tagstack,$parstack,$parser,$safeeval);
 
+  if ($Apache::lonhomework::type eq 'exam') {
+      if ($target eq 'web') {
+          my $token=$Apache::lonhomework::history{"resource.0.outtoken"};
+          if (($ENV{'form.doescheckout'}) && (!$token)) {
+	     $token=&Apache::lonxml::maketoken();
+          }
+          $body_tag_start.=&Apache::lonxml::printtokenheader($target,$token);
+      }
+      if ($target eq 'meta') {
+	  print "Cool, I was called";
+
+	  return (<<ENDSTORES);
+<stores part="0" name="outtoken" type="string" 
+ display="Document ID checked out" />
+<stores part="0" name="checkouttime" type="date"
+ display="Time checked out" />
+<stores part="0" name="outremote" type="string" 
+ display="Client IP checked out from" />
+
+<stores part="0" name="intoken" type="string" 
+ display="Document ID checked in" />
+<stores part="0" name="checkintime" type="date"
+ display="Time checked in" />
+<stores part="0" name="inremote" type="string" 
+ display="Client IP checked in from" />
+ENDSTORES
+      }
+  }
   if ($target eq 'web' || $target eq 'grade') {
     ($status,$accessmsg) = &Apache::lonhomework::check_access('0');
     push (@Apache::inputtags::status,$status);
@@ -109,7 +138,19 @@ sub start_problem {
         if ($status eq 'CLOSED') {
 	    $msg.='The problem '.$accessmsg;
 	} elsif ($status eq 'UNCHECKEDOUT') {
-            $msg.='The resource needs to be checked out';
+            $msg.=(<<ENDCHECKOUT);
+<h2>The resource needs to be checked out</h2>
+As a resource gets checked out, a unique timestamped ID is given to it, and a
+permanent record is left in the system.<p />
+<font color=red>
+Checking out resources is subject to course policies, and may exclude future
+credit even if done erroneously.<p />
+</font>  
+<form method=post>
+<input type=submit name="doescheckout" 
+value="Check out Exam for Viewing" />
+</form>
+ENDCHECKOUT
         }
 	return $result.$msg.'<br />';
       }